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Introduction 


This book has been written as an introduction to writing Machine 
Code programs and routines using Assembler language on the MSX range 
of home computers. 

Not so many years ago machine code was the programmers first 
language, but with the popularity of the home computer Basic has 
become the common language which most micro users cut their teeth on 
and machine code remains a somewhat grey area which most of us see 
in program listings as a series of numbers within DATA statements 
POKEd into high memory locations and then called by the USR command, 
and are left without a clue as to what is happening. 

Machine code programs, operate far quicker than those written_in 
Basic and that is one reason for a Basic program to contain a 
machine code routine in order to achieve greater speed, or it could 
be used to modify Basic to do tasks it cannot normally do. 

This book hopefully will make machine code clearer and more 
understandable to the average user, one will not need a degree to 
grasp what is happening, and computer jargon will be kept to 
minimum levels. 

Good Luck. 
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1 

Machine Code 
from Basic 


The Basic language is generally the simplest way of writing 
programs, it is easy to follow and debugging a faulty program is 
usually made quite easy with the editing facilities for altering 
lines in a program, so why use machine code? 


The main reason must be speed of execution, not purely based on 
games programs such as space invaders or the like which would not be 
worth playing if they were written in Basic, but more serious 
applications which will be shown in the book. In order to grasp 
some idea of the speed of a program written in assembler we will 
compare the execution time with a similar program written in 
Basic.:- 

10 SCREENO:KEYOFF 
20 WIDTH40:CLS 
30 TIME=0 

40 FOR X = 0 TO 959 
50 PRINT"B"; 

60 NEXT 
70 PRINT TIME 

Now entering the function key 'F5' or by entering 'RUN' followed by 
the 'RETURN' key one will see that the MSX took 151 time cycles (or 
3.02 seconds if line 70 was altered to TIME/50) to fill the screen. 

Another method for displaying characters is to VPOKE directly to a 
specific location on the screen. In screen 0 mode the top left 
position of the 40 column screen is 0000 hex, let us alter the above 
program so that instead of printing one character after another 


i 
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statement we shall print the 
tM Basic o£ ,„ ePory using the VPOKE 

using *-he screen area eit, e nt r, 

directly to « e 


Add l ine 


And alter 


15 z=4H0 
the following 


lines to read:- 


50 VPOKEZ+X,66 

70 l0 CATE,23:PHINT TIME 


Once again Run the program 

,,C so directly VPokeing to the screen is no qui cker 
ZeZt'L cursor renal ns in the same position whilst a 
statement is carried out, therefore line 70 repositioned the cursor 
to screen line 23 by the LOCATE statement. If you find that the 
'Ok' is displayed slightly off-screen then enter in direct mode 
'WIDTH37' and the 'RETURN' key to clear the screen and return to 37 
column display which is the condition the MSX wakes up in when first 

switched on. 

Now if that program, although not the most interesting in the world 
but quite effective as an example, is re-written in machine code and 
called by the A=USR(0) function from Basic the dramatic increase in 
speed will be instantly obvious. 


Program 1 Direct Screen Addressing from Basic 


Assembly language instructions used:- 

LD HL,nnnn LD BC,nnnn LD A,nn CALL nnnn 

These instructions are detailed in chapter 2. 


Enter 'NEW and ' 


Return' and input the program 
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10 CLEAR 200,&H9FFF 

20 FOR X = &HA000 TO &HA00B 

30 READ A:POKE X,A:NEXT 

40 DATA 62,66,33,0,0,1,192,3,205,86,0,201 
Enter 'F5' to run the program. 

The screen will instantly display the 'Ok' message and one could be 
excused in thinking that not much has just happened. But happen it 
has in that now a machine code routine has been placed in memory, 
starting at location A000 hex (40960 decimal), which will print the 
entire screen with the letter 'B' in a fraction of the time taken 
previously using normal Basic PRINT or VPOKE statements. 

Enter 'NEW' and 'RETURN' and this program will fill the screen:- 

10 DEF USR=&HA000:SCREEN0 
20 TIME=0 
30 A=USR(0) 

40 LOCATE,23:PRINT TIME 
RUN the program. 

Its speed is amazingly fast and time was printed as 1 or 2. 

As will be seen in the next chapter Assembly language is made up of 
several registers which we load with addresses and values, you can 
also check the codes in the Appendix. If we disassembled the DATA 
which was placed at A000 to A00B it would look like this:- 


1 

A000 

3E 

42 


LD A,42H 

2 

A002 

21 

00 

00 

LD HL,0000H 

3 

A005 

01 

CO 

03 

LD BC,03C0H 

4 

A008 

CD 

56 

00 

CALL 0056H 

5 

A00B 

C9 



RET 


We POKEd the DATA into memory starting at address A000 hex which if 
we convert to decimal gives us 40960, use the conversion chart in 
the Appendix if you aren't sure. The first two items in the DATA 

3 
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line were 62,66 decimal. 62 converts to 3E h e * 
to load the A register with the value of the Whl 


case 


was 66 (42 hex) in line 1 on the previ Qu 


next 


ch 


Pag e 


>Vte 


w 


The next three bytes were 33,0,0 which convert to 

hex signifies Load the register pair HL with the f 21 

in reverse order, low address first, i n this in llOWin 9 

load HL with the address of the top left corner lnStanc e - b 

RAM) which is 0000 hex, therefore in this n=,w. Scr 

order doesn't show us much as the address i<= r 

Zer o but 

will prove the point. 


' : j, 

r of scr e ;;; 

(v- 

zero w... Cas e 1(3 


th* 


* 


n e 


! *t 


v «t 




These were followed by 1,192,3 and the number i 

with the following two bytes in low byte firQt- Slgn ifi 6s T 

sx: ' hiqh w 

ml r J r m 4- +- 1 -v i n +* /^k D P rL 


w A uqh K 

The figure we want to load into BC is the amount of 0yt e s e c 
print to the screen. Screen 0 has a maxi bytes 

locations, 24 lines by 40 columns, therefore 


,a<3 fic 


a maximum si 2e We w i$h 


Ca Pacif v l o 

_ 960 d eci mal eQ ° f 960 

hex, which in reverse order becomes CO 03 (line 3 ) gUaA s 03 ^ 


Next came 205,86,0. 205 converts to CD hex wh-i^H 4 . 

cn translate* *. 

the address of the next two bytes which were in to Call 

11 reverse ord 

The address of the routine we wish to call i s 0056 hex ^ a9ain< 
we reverse them and convert to decimal these become 86 if 


NOTE The ROM section of memory contains many routines which ca 
called upon to perform different functions, location 0056 ^! 
contains the instruction to jump to a routine which fills VRAM area 
with the character contained in the A register. However before 
calling the routine one must ensure that HL contains the start 
address, BC the number of bytes to fill and A the data. And this 
our program has already done in lines 1 to 3. 


after 


final number in the DATA line was 201 which convei 
this command is RET for return, just as one would use 
routine in Basic. Remember that we went to this routine 

USR(0) statement which ^ ^i ike the 

___ wxncn is a Call instruction just 

GOSUB and to ouit i.. to r< 

guit the routine we enter the RET command 
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The USR statement can contain within the brackets an 'argument' such 
as an integer, string, single or double precision variable to pass 
on for the machine code program to use. This is explained in 
chapter 4, but for this example no data was required to be accessed 
by our routine so a simple call was made with a dummy argument (0). 

Now that routine although it executed in a fraction of the time it 
took using Basic was not quick to program, and a lot of thought 
would go into producing a simple output such as that. It is also 
more complicated translating decimal values back to hex and then 
translating them into assembly language Mnemonics and operands. 

In later examples of machine code we will use an Assembler, Editor 
called 'ZEN - Z80 Assembly Language Programming System for the MSX 
Micro-Computer' which includes a disassembler. An Assembler/Editor 
will do most of the dirty work for you and produce a printout such 
as we have just seen, furthermore entering assembly language is made 
childs-play, well almost, as they allow one to enter opcodes and 
operands such as:- LD BC,03C0H directly. After entering the listing 
one selects the assemble option and the assembler will then 
translate all the instructions into machine code automatically and 
output a version known as Object code. This small piece of jargon 
simply means assembled machine code ready to record on tape for 
future loading. 

It is virtually impossible to write machine code programs of any 
size without an assembler, it will pick up any false statements just 
like Basic does with the Syntax errors and it will allow one to run 
the programs and use breakpoints to stop the running at certain 
points so that one may check on the state of the registers etc. 
This is most important as the programs run so fast it would be 
difficult to make these checks without the facility. 


5 
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Program 2 


st-oring Screens 


New Assembly language instructions used:- 

LD DE,nnnn 

Two other routines within ROM allow the screen area t° copied 
into other parts of memory for storage and recalled when required. 
One may have a program which is menu driven in which options the 
user can make are listed on screen. That complete screen display 
could be stored somewhere in RAM and when needed a A=USRn(0) 
instruction will immediately transpose that block of memory back to 
the screen in a flash. 

Enter 'NEW' and 'RETURN' 

10 CLEAR200,&HDFFF 

20 DEF USR0=&HF000:DEF USR1=&HF010 
30 FOR X = &HF000 TO &HF00C 
40 READ A:POKE X,A:NEXT 

50 DATA 33,0,0,17,0,224,1,192,3,195,89,0,201 
60 FOR X = &HF010 TO &HF01C 
70 READ A .‘POKE X, A .‘NEXT 

80 DATA 33,0,224,17,0,0,1,192,3,195,92,0,201 
Now enter the 'F5* key or 'RUN' and 'RETURN' 

Once again the 'Ok' message was displayed almost immediately, and 
we now have this screen move routine in memory. 

One does not need to write a separate program to demonstrate this 
routine, providing there is a fair amount of text presently on the 
screen, if there isn't put something on the screen, anything. 

Enter in direct mode (without a line number) A=USR0(0) and 'RETURN'. 
The 'Ok' will be displayed instantly and the total displayed area 
has been copied into memory locations E000 to E3BF hex. It has not 
disappeared off the screen it has been duplicated into the other 
area. If one was running a program the screen could now be cleared 
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and the program continue until one needed to bring back the previous 
display. 

Now clear the screen by entering the 'SHIFT' and 'HOME' keys and to 
prove the point enter some characters onto the screen, it does not 
matter if one gets 'Syntax error' printed just get something on the 
screen. 

Enter in direct mode A=USR1(0) and 'ENTER' 

The screen will instantly change back to the previous display which 
was saved when we entered A=USR0(0) 

One could save more than one screen, providing they were moved to 
separate areas of memory, the Screen 0 text screen can contain up to 
960 bytes so one will need to adjust the program for different 
storage areas. Here is the assembled listing, remember it was in 2 
sections the first stores a screen:- 


1 

F000 

21 

00 

00 

LD HL,0000 

2 

F003 

11 

00 

E0 

LD DE,E000 

3 

F006 

01 

CO 

03 

LD BC,03C0 

4 

F009 

CD 

59 

00 

CALL 0059 

5 

F00C 

C9 



RET 

second section 

recalls 

it to the display 

1 

F01 0 

21 

00 

E0 

LD HL,E000 

2 

F013 

11 

00 

00 

LD DE,0000 

3 

F01 6 

01 

CO 

03 

LD BC,03C0 

4 

F01 9 

CD 

5C 

00 

CALL 005C 

5 

F01C 

C9 



RET 


The ROM routines which control the copying are at 0059 and 005C hex 
and as with the previous example certain registers need loading with 
data before they are called. Whether storing or recalling a screen 
of information registers HL require the source address. When 
storing a screen in the Screen 0 mode we know that the source will 
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be addres s 0000 So . 

the destine- ln lin e 1 Hr • 

where in R ° n address and 1S lo aded with 0000. DE represents 

"ith Eooo hi"* W1Sh it; to ^ stored 1 r de<i ” lth thS Start a<WreSS °* 

*ove and ia Re9ist «s Bc al from - =« in line 2 DE is loaded 

Wished to only Wlth ° 3C0 h ** <. 1177 ™ am ° Unt °* bYtBS t0 

could be i I 6 the t°P half o£ a eoi m al, i„ line 3, if O0e 

routine Which ^ 48 ° <01E ° hex >- Lin^i' 11063 ° t0 BC 

Line 5 which CarrieS ° ut th e copying and th • ^ thS ° al1 tQ ^ R °« 

-turns us to our Basic progrllT £ ° ll0Wed bY RET K 

Jhe second section f or recalli 

fashion with onlv a it ° g a stor ed screen works in 

— and h :' — —- - t::r 

for the destination „hi ch in scree^Hm T St ° ra9e ^ E °°°' 

thS 0311 to —ute the copying k t “ ** ^ °°°°' *»- «-.Uy 

amount of bytes to transfer, in BC re Whi ° h ±S at ° 05c - »e 

' " Bc ' trains the same at 03C0. 

As we now have the fani 1 

• • lity to store and recall nno 

:i nr “* ~~ *• ~ ■-'<» 
** — —^ :zz‘z:::zi:: “■ 

List the program and alter the following lines to read thus:- 


20 DEF USR2=&HF020:DEF USR3=&HF030 
30 FOR X = &HF020 TO &HF02C 
60 FOR X = &HF030 TO &HF03C 


And in line 50 alter the sixth number from 224 to 228 
and line 80 alter the third number from 224 to 228 


NOTE Care must be taken when modifyinq an ov-i +. • 

^ an existing line on screer 
In lines 50 and 80, which exceed one qp rOQ n i • 

-line, Gn^nro 

not press 'RETURN' until you have moved the cur <5 4 . Y ° U ° 

complete program line otherwise the msx w - ln ° thS Gnd ° f th 

. „ 8 MSX Wl11 f orget the character 

shown on the next line and shorten i • uer 

rten the line so producina 

message. List the program before running it Srr ° 
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After running the altered n twt*-:.™ 

ed program one should have the facility to 

store another screen 

^ ^ in memory, only this time we have 

written the copying routine at- pnon „ ,4 .. 

at F020 and the recall routine at F030 

hex, and the storing of this <!ppnn^ _ 

y cms second screen commences at E400 hex 

Storing a second screen is achieved by entering:- 

A=USR2(0) 


and to recall to the display:- 
A=USR3(0) 

If one requires three screens to be stored the following alterations 
should be made:- 


20 DEF USR4=&HF040:DEF USR5=&HF050 
30 FOR X = &HF040 TO &HF04C 
60 FOR X = &HF050 TO &HF05C 


And in line 50 alter the sixth number from 228 to 232 
and line 80 alter the third number from 228 to 232 


Check the listing and run. 

And these are the alterations for the fourth screen:- 


20 DEF USR6=&HF060:DEF USR7=&HF070 
30 FOR X = &HF060 TO &HF06C 
60 FOR X = &HF070 TO &HF07C 

And in line 50 alter the sixth number from 232 to 236 
and line 80 alter the third number from 232 to 236 

Once again list and run the program. The routines are accessed by:- 


A=USR0{0) 

stores- 

A=USRl(0) 

recalls 

A-USR2(0) 

n it 

A=USR3(0) 

II VI 

A=USR4(0) 

M it 

A=USR5(0) 

II II 

A=USR6(0) 

IV II 

A=USR7(0) 

II It 
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Z80 Instructions 


In this Chapter, we're going to take a broad look at the way th 
Z80 chip interprets the machine code numbers, the Z80 Registers and 
the way they are generally used, and then at the different types 0 f 
Assembler instruction. You'11 find a complete list of these mnemo„ lc 
instructions in the Appendices - listed alphabetically and 
numerically by the first byte of their instruction code. There are 
several books available which explain each Z80 instruction in 
greater depth, rather like an encyclopaedia and almost as large, but 
these are general references and do not show examples for specific 

inf r ° S t" 6 the MSX ran9e - H ° WeVer “ "outr.. -re det 

information regarding the Z80 instruction set then the purcha 
should prove worthwhile. t^cnase 


BASIC has well over 200 instructions - taking 
subtle variations like 'IF-THEN GOSUB' and 'if 
machine code has nearly 700 - but don't panic, 
simply variations on a theme. 


into account all the 
THEN PRINT'. Z80 
many of them are 


BAST r l 33 yOU WiU haVe alreadY a PP rec i a ted, is that one 

BASIC instruction calls up a host of machine code instructions 

Within the interpreter. when you write in machine code you have to 

generate those instructions yourself - although you can, of course, 

up useful routines resident in the ROM section of memory (as 

indeed some of the demonstration programs in this book do). 


in 
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It is possible to write programs without having a full knowledge of 
the entire instruction set - indeed many people do quite happily and 
successfully, adding to their knowledge as they gain experience. 
The same is true to some extent when programming in BASIC. 

For example - how would you do a count of 1 to 1000 in BASIC? 
probably 

10 FOR 1=1 TO 1000 
20 NEXT 

30 PRINT "ALL DONE" 


Fine, but supposing you didn't know about FOR-NEXT loops? You'd 
probably tackle it this way:- 

10 A=0 
20 A=A+1 

30 IF A<1000 THEN 20 
40 PRINT "ALL DONE" 


But supposing you didn't know about IF-THEN constructions either. 
You'd really have to put your thinking cap on:- 

10 A=0 
20 A=A+1 

30 B=-1 *(A<1000)-2*(A=1000) 

40 ON B GOTO 20,50 
50 PRINT "ALL DONE" 


As you can see, the programs become longer - and take longer to run 
- when the most suitable commands are not used. Knowing all the 
commands at your disposal helps you to make your programs shorter 
and/or faster running...and your life easier. Usually machine code 
programs run fast enough even when written the 'long way round', but 
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large number of repetitive actions are involved, such a§ 
when a very even a feW microseconds knocked out of 

in a Chess Game progra ' erable time saving when the program i s 

loop can result m a 

running. 


m( . his book have been 

Having said that, the P rog ^ ^ nQt necess arily the 

demonstrate principles, 

shortest way of achieving the desired result. 


written t Q 
fastest 0r 


What do all the numbers mean? 

Machine coding, as you know, is all about numbers. A number ca n 
mean one of two things to the Z80 central processing uni in your 
computer. It can mean an instruction or part of an instruction to 
do something. Or it can mean a piece of information to be worked on 
or used in some way. Fortunately, the Z80 knows exactly which of 
these the number represents (in a correctly written program), and 
acts accordingly. 

Take an instruction to load Register A with the value ' 7 1 (we'll be 
discussing the Registers in more detail later). In Assembly 
language mnemonics this instruction is written LD A,7 . In machine 
code language, the instruction is represented by the two hex numbers 
'3E 07'. When the Z80 sees the first of these it says "3E means I 
must load the next number along into Register A". It takes up the 
7, puts it into Register A, then looks to the number after the 7 for 
the next instruction. So it wouldn't be confused if it saw, for 
example, the two hex numbers '3E 3E* - this time it would load 3E 
hex (62 decimal) into its Register A, then look to the number after 
the second 3E for its next instruction. 

single byte of Information can have a value from 0 to 
(0 to 255 decimal). Let us take a look at that in more 

detail. 

y © consists of 8 bits, each bit being a binary 0 or 1. so the 

19 
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binary number 11001001 can be represented thus:- 


Bit No: 76543210 
Binary Value: 11001001 


Wherever a '1 * appears in the binary representation, raise 2 to the 
power of the corresponding Bit Number, add the results together, and 
you have the decimal value of the Binary number. Thus, using the 
above example:- 


2 to the power 7 
2 to the power 6 
2 to the power 3 
2 to the power 0 


128 

64 

8 

1 (any no. to the power 0=1) 


201 


So the binary number 11001001 is 201 in decimal. 


To convert a binary number to Hex, split the eight digits into two 
groups of four (called 'nibbles'). Thus:- 

Nibble 'bit' no.: 3210 3210 

Binary value: 1100 1001 

Left side: 2*3 = 8 Right side: 2 A 3 = 8 
2*2 = 4 2 A 0 = 1 

12 9 


Remembering that decimal 12 = C in hex, the hex value of binary 

11001001 is C9. 
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How the Z80 handles 2-Byte numbers 


• tractions to the Z80 tell it to operate not on one byt. 
Many ms . but on two bytes. For example, an Assembly 

- as in 0Ur ' be . LD HL,49AFH 1 (the ’H’ at the end tells th* 

instruction mig a hex numb er). Two-byte numbers increase th, 

....«. - ~ °-“” s ^ 

Z ‘- ** " ui •“ *°»« 

memory locations in your computer. 


In the instruction LD HL,49AFH, we want the High byte, 49 (hex, to 
go into the H Register, and the Low byte AF (hex) to go into the 1 
Register. The machine code instruction for loading H and j, 
Registers with 'direct' data is 21 hex. When the Z80 sees 21 hex as 
an instruction, it takes the NEXT number and loads it into the l 
Register. That's right - the L Register. Then it takes the 
following number and loads it into the H Register. So the machine 
code for LD HL,49AFH looks like this:- 


21 AF 49 (hex) 


Note how, in actual machine code, the order of the two informatioi 
bytes is reversed. Now you know why. 


When using an Assembler, you don't have to worry about th ■ 
the Assembler sorts it out for you But if 1S P ° 

machine code by hand, as was shown in chapter 1 t ^ 
the two information bytes at your peril. ' ° r9et ^ ° rder 


Needless to say h 

discuss Register ' pa JsTateTonT TJ R69iSter P air "ith data (w< 
machine code U sting bef ' the Low b yte always appears in 
remember, you write the e High byte. i n Assembly langt 

ssembler p ut things i n the c ^ normal wa yr’ and let 

he c °rrect order. 
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Inside the Z80 chip 

The elements that go to make up a Z80 chip include an Arithmetic- 
Logic-Unit, which performs all the (simple) arithmetical and logical 
functions, a 'control box' which makes sure data is passed in, 
decoded and acted on in the correct order, and a number of 8-bit 
(one byte) and 16 bit (two-byte) Registers. Just to confuse you, 
pairs of the one-byte Registers can also be used as two-byte 
Registers. 

The Program Counter 

Let us look first at the Program Counter (PC) two-byte Register. 

This holds the address of the NEXT instruction. It is automatically 
up-dated every time a new instruction is executed. However, the 
address it holds can be changed by, for example, a CALL instruction 
(like GOSUB in BASIC). 

In this case, the address in the Program Counter is put aside - on 
the STACK - and the address CALLed is put in the Program Counter in 
its place. When the CALLed routine is done it meets a RET (RETURN) 
command, which takes the two-byte number ON THE TOP OF THE STACK and 
puts it back into the Program Counter. Execution then continues 
from that address. If you use the Stack (and you will use it), it 
is important to remember that the next instruction address after a 
RETurn is taken from the top of the STACK. Many a program has gone 
wild because a number has been unwittingly left on the stack, on 
the other hand, the fact that you know that the address of the next 
(apparent) instruction is on the Stack can be useful when, for 
example, transferring data to a subroutine. 

A number of other instructions also affect the PC Register - jump 
instructions (JP or JR) for example. But for most instructions, the 
length of the instruction (including any information data elements) 
is added to the PC by the chip’s control system, so that it knows 
where to look for the next instruction. 

15 
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rr-. “ “t« r • 

vou switch on. 


the Stack Pointer (SP), keeps track 
many instructions enable you, as welj 
The Stack area is within the RAM qj 
is set up by the ROM routines wh eri 


• H set up your own address for the Stack but ** 
you can if you wish sec P i Bar KWARDS in memory, and it uses , 

....—« <“■ “ ! . p... ■< pi..- ... 

iast-in, first-out sys em top , but you can't touch th, 

put plates on top or take 

plates anywhere else in the pile. 


The other point about the Stack 
delivers two-bytes of data. So, 
the Stack in that order, and the 


it will look 

like this:- 

Address 

Contents 

F08B 

CO 

F08C 

33 

F08D 

BO 

F08E 

22 

F08F 

AO 

F090 

11 


is that it ALWAYS accepts 0r 
if we put 11A0H, 22B0H and 33C0H on 
Stack Pointer is loaded with FO90 


The stack Pointer in the 280 will be pointing to the last (low) byt 

o the 33C0H data. If another piece of two-byte data - say 4567 
is put on the Stack. the n • 

(decremented), the first (high, byteThT • ^ ■ ** 0 " 

-ow pointed to hy the stack Pointer loZ ” Z ^ ^ 

address is DECREMENTED again andth ' StaCk P ° inte 

h6X ' P»t on the Stack , a t'p 0 89 ) ^ ^ ° f ^ ^ 6 

When taking data off the St 

example, fi rs f- the a ° ’ the system works in reverse. in ou: 

L °w order byte (67 hex) is removed, the Stac) 
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pointer is INCREMENTED, the high order byte (45 hex) is removed and 
the Stack Pointer INCREMENTED again. So now the Stack Pointer is 
once again pointing to the low order byte of the 33C0 hex data. 

The 8-Bit Registers 

There are two sets of 8-bit Registers:- 

A, F, B, C, D, E, H, L 
and A',F',B',C’,D’,E',H',L' 

(Notice the F and F' Registers have been put next to the respective 
A Registers - that's because they are usually associated with the A 
Registers, and they have a function all of their own). 

Only one set of these Registers can be used at a time. Why have two 
sets? So that you can 'stop' in the middle of one operation, switch 
to the alternate set, carry out an intermediate operation, then 
switch back and continue with the original operation. There are 
several ways of passing data between one set and the other. 

Registers B and C, Registers D and E, and Registers H and L are also 
used as Register pairs to hold two-byte data. In a few commands. 
Registers A and F are also treated as a pair. 

The A Register 

The A Register is the Accumulator. It's where Almost All of 

the Action takes place. It is like Grand Central Station and in any 
program of consequence, it is kept extremely busy. Practically all 
comparisons, single-byte adding and subtracting instructions, and 
many special 'transfer' and 'load' instructions demand use of the A 
Register. God bless its cotton socks. 

The B and C Registers 

Several commands use the B Register or the B and C Registers 
together as a Byte Counter. (BC = Byte Counter - easy to remember). 
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, . . always be 

_uiv command, which mu 

mple the D JNZ AsS ction says ’Decrement whateve^ 

Take £°r be i. This ms it is not zero as a result, 

£0ll0Wed „ id in Register B hy U « Label ’. If. U*e a FOR-NEXT 
value is held denoted by ition s required being held 1„ 

jUmP W TsiC with the number of ^ ^ continues with the next 

loop in BASI , b reaohes ze ro, P = Dec rement and Jump on No„ 

Register B. the mnemonic 

instruction. 


Zero)• 


p Registers B and C as a pair 
,-. q . ’LDIR') use or small chunks o£ 

^permitting 3 f° r sample the transfer^ ° extreme ly quickly. 

data from one area in the ^ in this way is held in the 

The number of bytes to be 

Register pair BC, 


flpart from these special uses, these two Registers 
together or independently for your own requirements. 


can be used 


The D and E Registers 

These too can be used independently, but are used together by some 
Z80 instructions to define a Destination address. For example, the 
DEstination address of a block transfer of data (the 'LDIR' command 
again) is taken from Register pair DE: you have to put the address 
there, of course. 


The H and L Registers 

. These Registers are used as a na ir f 

instructions, in the 'LDIR' ^ qUlte a number of 

«* dafca to he transferred ls TT**' the Start 

- so don’t forget to put it fr ° m ^ COntents of HL Regis 

few commands which allow u ' y ° U that there are qi 

data are «. y ° U t0 USe the HL Registers to 'point 
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The F or 'Flag' Register 


This is 
Registers 
purpose 
operation 
status. 

'tested' 
returns. 


a very important Register indeed. unlike the other 8-bit 
you cannot load data into it in the normal way. its 
IS to hold Flag results of any logic and arithmetic 
un ertaken, and for some other instructions, to 'flag' a 
The important point is that some of the Flags can be 
^ ’ for example, conditional jumps, calls or 


NOTE THAT WHILE MOST OF THE INSTRUCTIONS AFFECT SOME OR ALL OF THE 
FLAGS, FLAGS REMAIN IN A CURRENT STATE UNTIL AFFECTED BY A 
SUBSEQUENT INSTRUCTION. This means the state of a Flag can be 
tested several instructions after the instruction that affected it 
but do be sure that the intermediate instructions do not affect 
the Flag in question. This feature can help to reduce the amount of 
coding needed. For example, all but two of the 'load' instructions 
do not affect the Flags at all. So if one of two subroutines are to 
be called, depending on the status of a particular Flag, and if both 
subroutines require the same 'load' at their start, then the 'load 1 
can be done before the conditional test is made. 


Certain bits of the Flag Register are allocated to specific 
functions, as follows:- 

Bit Number: 76543210 
Function: S Z - H - P/V N C 
Testable: * * * * 

The 'Testable' line indicates which of the Flags you can test in one 
way or another using the instructions available. Now we'll look at 
the functions of each one-bit flag. 
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ThjLA^^9- n -^ s . the value of the "^^"luding ’shifts’. 
This ropl " logic opera ' 'repeats’ the valu e 

— n o. .. «££‘I b ; o the A Register. At tepe 

a byte is trans that byte. 

the post significant bit 


st significant) is used to ind ic 
in many instances, bit 7 ®° g complement’ notation, for e XaR( ® 

. particular condition. In n later ln this chapter), ^ * 

(a brief discussion of This means the binary numK 

represents the SiCR of t- from -.2. to .128. ^ 

re only 7 bits lohg. if the number is *». *» 


but. repi ci:,v 

are only 7 bits long, »!») if the number i s m P o> <5 

instance, Bit 7 is is POSXTXVK. 

and RESET (equa when a program is • communi Cat ° f 4 

data byte can also play a ro printer The q 1Cat lh q . 

with input/output devices, such as lag enab le 

Bit 7 of such a byte to be tested. 


number of Assembly commands allow the S Flag to be te 

i_• j . 


ste<j 


adding a 'P' (is it Positive?), or an 'M' (is it NEGATIVE?) ’ ^ 

command JP (Jump), for example, can be turned into a CONcj 

jump by the addition of P - JP P,Label . This tests the 

and if it IS positive (i.e., equal to zero) as a r.J, S P K 

of 

previous action, then the jump will occur. Otherwise Soin e 

continues with the next instruction. Process^ 


The Z or Zero Flag 

This Flag is used to indicate whether or not the 

arithmetic operation is zero, or whether or not a • reSUlt of an 

succeeds. comparison' test 


When a result is Zero or a comparison test succe „ 

Set t° a Otherwise, it is reset to a 'O’ ' “ 


~ • 

The 2 Pla9 can be tested by addinq • . 

Non-Zero?) to certain Ac. 9 1 ls lb z ero?) or ’NZ’ (is >* 

IMTurn on Zero) provides Tc V Coramands - For example, ’RET »' 

° n itio nal return from a subroutine: i! 


be 

instr' 


the -■ 
a ccor< 


This 

arith 

carry 

tests 



The E 


This 


accoi 


(Pari 


reset 


The i 


Decii 


aff e< 


sign 


Fina 


Flag 


exec 


c onc 

'CAl 
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a previous operation has left the Z Flag set to 1 1 \ a RETurn will 
be made. Otherwise processing will continue with the next 
instruction. (As you can see, you don't have to worry too much about 
the actual value of the z Flag bit - the Z80 looks at it and acts 
accordingly on your behalf). 


The H or Half-Carry Flap 

This Flag is used by the computer during Binary Coded Decimal 
arithmetic operations, to indicate whether or not there's been a 

carry from bit 3 to bit 4. it cannot be used in any conditional 
tests. 

The P/V or Parity Overflow Flag 

This Flag has three functions. Some instructions set or reset it 
according to whether the byte of a result has an even number of '1's 
(Parity Even = Flag set to "1"), or an odd number (Parity Odd = Flag 
reset to "0"). 

The second use of the P/V Flag is to indicate, during Binary Coded 
Decimal operations, whether or not Bit 7 (the 'Sign' Bit) has been 
affected by an overflow from Bit 6, thus accidentally changing the 
sign of the result. 

Finally, during block transfer instructions, such as 'LDIR', this 
Flag is used to detect whether the counter has reached zero. 

The Flag can be tested by adding 'PO' (is the Parity Odd?) or 'PE' 
(is the Parity Even?) to commands used to transfer program 
execution. For example, a CALL command can be turned into a 
conditional CALL if the Parity Flag is indicating 'odd', by writing 
'CALL PO,Label' instead of the unconditional command 'CALL Label'. 
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Z80 during its 

This Flag is ^ be tested. 

calculations, and 


own Binary Coded Deci^g 


‘6* 


The_C_or_Carrl_Flaa first, it is used to indicate w heth 

This Flag plays a dual has result ed in a 'borrow’. I£ # 

or not an addition or su ^ ^ tQ »,». Otherwise it is re Se , 

borrow has -cured ^ “ d s (e.g. CP B - which compares t h , 

to "0". since co "P arlS contents of Register A) are achi eVej 

contents of Register B wit Register A (and discard!,, 

by subtracting the selected Regis whether the select^ 

». “ »>" “ J, , 

- «>■ . 

(which produces a No Carry). Very useful. 

The second use of the Carry Flag is in many of the rotate and shi ft 
instructions - which move data along the byte one way or the othe, 
in a particular manner. For these instructions, the Carry Flag i, 
used as a 'ninth' Bit. For example, the RRA Assembly command 
(Rotate Right the Accumulator - Register A), moves Bit 0 of Register 
A into the Carry Flag, moves whatever was in the Carry Flag into Bit 
7 of Register A, moves what was in Bit 7 to Bit 6 - and so on. Thus, 
this particular command effectively rotates the information held by 
the bits round one and includes the Carry Flag in the process. 

With logical commands AND, OR, XOR, the Carry Flag is always set to 
'O' (No carry,. AND A and OR A wiil leave Register A intact, since 
the Register is being ANDed or ORed with itself, whilst XOR A not 

only Clears the Carry Flag but also dears Regis^r A as th 

be no 'exclusive' bits if it ic k • /as there can 

if it is being X0Red with itself.. 

The Flag can be tested t-n „ , 

addition of * C ' (Carry) or 'Jr' "iT C ° ndlti ° nal co ™"ands by the 

CALL command can be turn a • ° Carry} to the command. Thus a 

writing 'CALL C,La be 3 ““ “ the « a 9 Is set, by 

instead of 'CALL Label. 
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t-he Commands affect the Flagg 


How 

The following Table shows how the Flags are affected by various 
fvDes of Command. Commands not listed - e.g. 'PUSH' and most LD 
commands - do not affect the Flags at all. Please note that, where 
unnecessary, the 'Register' element of the Command has not b 
included in the Table: thus the OR command could be OR A f OR , 
and so on - all having the same effect on the Flags. Only those 

Flags that can be tested have been included. 


c 

> 

COMMAND 

ADD A,ADC,SUB,SBC, 

CP f NEG 7 

and,or,xor o 

INC,DEC 

ADD RR,CCF ? 

RLA,RLCA,RRA,RRCA ? 

rl,rlc,rr,rrc, 

SLA,SRA,SRL,DAA ? 

i 

SCF 1 

IN 

ini,ind,outi,outd 

INIR,INDR,OTIR,OTDR - 

LDI,LDD 

LDIR,LDDR 

CPI,CPIR,CPD,CPDR 

LD A,I; LD A,R; 

BIT 


FLAGS 

Z P/V S 


? ?V ? 

? ?P ? 

? ?V ? 


? ?P 


7 


? ?P 

7 

1 

7 

0 

? ? 

? IFF 


*? 




I 

. 
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kET! n the rc -' u - result 

? • <*(*>*» M rity ol 

“P* itfcrfl° w in r 


’ " "Lnd* on 0» 

IV • OoP'^'’ -era 

0 , FtM rc3 ‘- ntained 

. pug sot to eV j 0 us state r 

. . rw unaf looted* P floP leva nt informatron. 

- °rr:rjsr«- —— 

where there are 

i table for JumP, CALL,J U » ( 

• s0 the conditional tests ava 

7o summarise 

Relative and RETurn oon»an • 

-a* is Zero, < 


Z 

NZ > 
C * 
NC = 
PO = 
PE = 
P = 
M = 


ma 

If result is Zero, act. 

If the result is Not Zero, act. 

If there's a Carry, act. 

If there's No Carry, act. 

If Parity is Odd, act. 

If parity is even, act. 

If the Sign Flag is 'positive <S=0), act. 
If the Sign Flag shows a minus (S = 1), act. 


The Index Registers IX and IY 

We now come to two very valuable 16-bit Registers in the Z80, the 
’Index* Registers. Unlike Registers A to F, there is no 'second 

set’ of Index Registers: their contents are accessible to both of 
the A to F Register sets. 

The ’load’ instruction commands related to these Registers can 
deed must, even if it's 0) include a displacement value. This 
es, for example, data tables to be very easily set up, using 
the Register ix or IY to point to a 'base' address, an d the 
P acement to point to the particular place required in the table. 

example will help to explain this. Supposing we decide to have a 
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Me of information that contains a number of names, addresses and 
numbers. We allocate, say, 20 bytes to cover the name 

60 bytes to cover the address data, 12 bytes to cover e 
data, ° 1 

telephone number data. 

Table will then consist of a series of chunks, each 92 byt 
long ( 20 + 60 + 12 ). we know that the telephone data for any name 
ns a the 80th byte from the start of the name. If we 'pornt 

^ X Register to the start of the name in the Table, we know t at 

... , . , tyj-rd This saves counting out the 

the Telephone data will start at IX+80. This saves 

bytes to get to the correct address. A typical program mi 
like this:- 


LD B , 11 
LD IX,NAME3 
LD DE,BUFFER 
GETTEL:LD A,(IX+80) 

LD (DE),A 
INC IX 
INC DE 
DJNZ GETTEL 
Next operation 

rhe first instruction sets up Register B as a counter. 

?he second instruction loads up the IX Register with the 2-byte 
iddress we require - that for NAME3. 

+• loads up Registers DE to point to a BUFFER 

-he next instruc ion the Te i ep hone number - possibly for 

irea, where we want to 

>rinting out. 

. . h start of a little loop which will collect the 
,e then come to t ^ collect one byte, then increment 

>ytes of data from increment the value in the DE 

he value in the IX ^ ^ fcQ the next address along), then 

:egisters (i.e move .counter', B reaches zero. 

:ollect another byte and so on unti 




' 

•<: :v.• ..V : 
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Nate that LD A,(lx+80 ) means load Register A 
he found at the address pointed to by IX+80. 

means load the data byte in A into the address 
pa i r DE . 


wi th the data byte ^ 
Similarly. LD (DE) 

held m the Regi st ^ 


The iy Register can, of course, be used in a similar way. 
as loads', the Index Registers can be used for ADD, INC, 
and SET commands - INC (IX+80), for example, means go to the 

pointed to by IX+80, and whatever byte is stored there, add 
it. ' 


RLC ' 81, 
addr e Ss 


one f 
lo 


How big can the displacement value be? Glad you asked - because 

displacement value is treated as a signed number. That means it ^ 

be 7 bits long, with the Most Significant Bit representing the 

of the value. So, to answer your question, the displacement valu" 

can be anything from -128 to +127, 'O' being treated as a positJ 

value. e 


The I and R Registers 


Two more 8-bit Rregisters exist in the Z80 which can be accessed 
by commands. These are I , which stands for the Interrupt— Page 
Register, and 'R', which is the Memory-Refresh Register. 

The I register is used in a special interrupt mode of operation to 
which the Z80 can be set (by command), and it stores the high-byte 
of an address that will be called in the event of an 'interrupt' 

process. The low-byte is generated by the device generating the 
'interrupt'. 


Let us briefly cAaumic 

y ^ — «« interrupt. when you wr 

a program, providing all is well, it will ..u 

, run the way you want 

to, branching to subroutines and returning to th 

scheduled. However, some input/output devices h maln Pr ° gram 

while your program is running quite happily IT , attention e ' 

Processor' (VDP) in your MSX is one of th ! * Vldeo Dis P : 

or tn ese devices'. 
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An interrupt signal is sent by the device to the Z80. It says 'Hang 
on i need attention'. Your 'main' program stops while the 
interrupt request is attended to - in the case of the VDP it is to 
'refresh' the screen display - and then control is passed back to 
the main program, to continue where it left off (see footnote). 

The programmer can call on the interrupt process himself, and 

indeed, you’ll find a 'hook' at address FD9A and FD9F which is 

accessed 50 times a second. A Hook is 5 bytes in RAM which are 
initialised to Returns (they contain code C9 for RETurn) and the 
user can utilise these 5 bytes to do a CALL nnnn to his own 
interrupt routine and return to the main program. 

There are three interrupt modes, called up by the commands IM 0, IM 
1, and IM 2. In Interrupt Mode 0 - which is the mode your machine 
is in when you switch on - the external device must provide the 
instructions for what it wants the Z80 to do when it makes an 
interrupt request. 

In Interrupt Mode 1 (which is the mode the ROM places the Z80 within 

microseconds of you switching on), when an interrupt request occurs 

an automatic jump is made by the Z80 to memory address 38 hex. The 
current location of any program running at the time is, of course, 
temporarily stored so that after the interrupt routine is complete, 
a return can be made to the original program. This interrupt mode 
j always calls to address 38 hex. On the MSX, 38 hex provides a jump 
to the Hardware Interrupt routines at address 0C3C hex. 

• • 

Footnote 

I Users who require further information on the VDP should refer to the 
publication 'Behind the Screens of MSX Home Computers' by Mike Shaw, 
j which examines in detail the operation of the VDP and the way it is 

used in the MSX. 
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t it start, 
s upP lied b V 


a similar * of the 

- the calliI ” 

aeJicTIs al«ay* zero. de the 2-byt, 

„ t0 plus the next * dd ~ S ; ich control xs the, 

address of cne 

PaSS6d ' arv to ensure that an interrupt 

in some programs it may be necess a Dissable Interrupt 

does not occur during ^ £ or heaven's sake remember to 

command (Dl) lets you do is program i s 

Enable Interrupts (El) again when that part 

complete. 


device 


Finally, the Refresh ’R’ Register: this is provided to refresh 
dynamic memories automatically. You can use this as a kind of 
'software clock', but since its values run only from 0 to 255 
decimal, it's not exactly the most useful Register available. 
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E THE assembly commands 

f 

I •' 

1 

There are a number of ways to classify the many Assembly commands 
you have at your disposal. We are going to herd them together under 
five headings to cover instructions which: 


1. Transfer data from one place to another 

2. Manipulate and test the data in some way 

3. Re-route program running sequence 

4. Handle input/output devices 

5. System controls 

Before we go into the commands, it may be useful to spend a few 
brief moments looking at the way a command is carried out by the 
Z80. 

Every instruction is executed in three phases. In Phase 1, the 
instruction is fetched from the correct place in the program. The 

[ 

i Program Counter tells the Z80 where to look (we dealt with this 
earlier). The first - perhaps only - byte of the instruction is 

1 ' 

then placed in a Register the Z80 keeps all to itself (called, 

! 

believe it or not, the Instruction Register). In Phase 2, the 
instruction is decoded by the Z80 - that is, it sets up the cycle of 
operations for the third phase, which is to actually execute the 

I. 

instruction. 

Each phase operates within finite steps, called clock cycles or T- 
States. The cycles themselves operate in 'machine cycles' - called 
'M Cycles'. The shortest machine cycle lasts three clock cycles. 
Now as each cycle means a discrete unit of time, the more cycles an 
instruction needs for its fetching, decoding and execution, the 
longer it takes to execute. Pretty obvious really. 

I ' , : . 
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llv speaking the more bytes the,, 

fall this is. ^ enera y tak es to execute. However, «* 
The point Ot a.- t|)e longer it a part, so so,, 

.« to *" *” tr ^ the ' instruction also ^ ^ byt e len ,th. F 0: 

’coeplesity ° ion?er than others » t Register pair * 

instructions - instruction to DEC A, also , 

"* r ' P r , ak es 1 machine cycle, 6 T 4 estates. DEC A U 

. DEC BC - takes 1 machine c> ' { the dod, j 

one byte instructron, tak . microsecond i 

«aster by 2 T-States - or on. at 3>58 „„r on the MSX. 

•running' at 2 MHr. or eve 

this discussion on machin* 
For the newcomer to machit le codl ^' enough t o cope with: it i, 

cycles and T-States should be * the actual speed of ever, 

beyond the scope of this book to nt only when one has gainei 

■•••>••*“■■ .. —*» ~ a *- 


The 'Bracl ' 0 ^ 1 Convention 


Before we 
'convention' 
of 'brackets 


finally get down to the commands, there is one 
ou must be perfectly clear about - and that is the use 
within a command. 


An address can be referred to in two ways. If we want the address 
itself, it is written in the normal way - 1 234H, for example. If « 
wish to refer to the CONTENTS of the address, then the address is 

placed in brackets. 


Thus the command 'LD HL,1234H' means 'load Registers HL with the 
address 1234 hex'. You will recall from an earlier discussion that 
the Low byte goes into Register L (34 hex), and the High byte goes 
into Register H (12 hex). 


The command 'LD HL,(1234H)', on the other hand, means 'go to address 
1234 hex, and whatever byte you find there, put it in Register L. 
Then go to the next address - 1235 hex - and put the byte you fi nd 
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there into Register H'. (Look back a few pages to refresh your 
memory on how the Z80 requires addresses to be stored). So if 
addresses 1 234H and 1 235H hold bytes 89 hex and 67 hex respectively, 
then HL will be left holding the value 6789 hex after this command. 

Similarly, take the command 1 LD A,(HL)' . This means 'go to the 
address pointed to by Registers HL, and put the byte you find there 
into Register A'. if the HL Registers had been 'set up' to hold 
1234H, then whatever byte is at that address (in our example above, 
it was 89 hex) is loaded into Register A. if HL Registers had been 
'set up to hold 6789H, as in the second example above, then 
whatever byte is at the address 6789H gets loaded into Register A. 

Note that the command 'LD A,HL' cannot exist, since you will be 
trying to load two bytes of data into a one-byte store. Even an MSX 
computer can't do that. 


1. Data transfer commands 

In this section, we will be looking at all the different ways you 
can shift one or more bytes of data from one place in memory to 
another - and that includes shifting data around the Registers 
themselves. For convenience, it also includes the 'creation' of new 
data - that is, loading a Register with a specific value rather than 
a value to be found elsewhere in RAM. What we won't include in this 
section are the commands which read or write to input or output 
devices. 

You may think this an obvious point to make, but we'll make it 
nonetheless: data remains in an address or Register until it is 
'overwritten*. Thus, if we say 'Load Register A from Register B (LD 
A,B) then both Registers A and B will be holding the data that was 
in B, and the data that was in A will be lost. 
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straightforward 1 0 ^ 


fers are achieved by a 
All 8-bit transfer flowing tornat: 

instruction *»** «*• 

L D destination,sourc 

L D B,D - which means load th, 
Thus a typical Register B. 

contents of aVai lable:- 

The following table 


Source of the load 


Load Dest. 

A x x x x x x x x 

B X X x x x x x X 

c X X X X X X X x 

D X X X X X x x x 

E X X X X X X X x 

H xxxxxxx x 

L XXXXXXX X 

(HL) xxxxxxx 
(BC) x 
(DE) x 

(IX+d) xxxxxxx 
(IY+d) xxxxxxx 
(nn) x 


X 


X 

X 

X 

X 

X 

X 

X 


X XX 

X X 

x X 

x X 

X X 

x X 

x X 

X 


X 

X 


The Registers down the left 
a load, and the Registers 
load, in the command format 
where a command is available 


hand side represent the DESTINATIONS of 
across the top represent the SOURCE of » 
LD destination,source’. The x’s denot« 
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reading across the top line, you can have as valid commands: LD 
A# ld A,B; LD A,C; and so on. Notice that no command is 

Pi f A f , 

mailable to load Register D from the address pointed to by Register 
pair BC (i.e. there's no LD D,(BC) command). Sad - but no problem. 


In the Table, 'nn' means a two-byte number, which could represent an 
address. You'll notice that only Register A can be loaded from the 
contents of a specific address (top line - LD A,(nn) ). Also, at the 
end of the Table, you'll see only Register A can be loaded into a 
specified address. Let’s discuss the ramifications of this. 


If you want to load a specific address with a data byte, you can 
either do it by first placing the data byte in Register A (if it 
isn't already there), then do a 'LD (nn),A' command (nn being the 
required address). Or - take a look at the horizontal line for 

'(HL)'. If HL is loaded with the desired address - i.e. LD HL,nn 

(we'll come to that command later on), then data from any of the 

Registers A,B,C,D,E and yes, even H and L can be loaded into the 

desired address - using the LD (HL), 'register' command. 

If you study the Table, you'll see that the same applies 'in 
reverse' - that is, you can load any of the Registers (including H 
and L.) from the address pointed to by the HL Registers (vertical 
I column (HL) ). Thus, you can write LD C,(HL) - meaning load 

f Register C with the contents of the address pointed to by HL. Easy 

isn't it, when you know how. 


Now let’s look at another aspect of this Table - that 'n' column on 
the right hand side. As you've probably already guessed, 'n' stands 
j for a data byte - any value from 0 to FF hex or 255 decimal. 
Notice, now, how you can load a specific byte of data into the 
address pointed to by HL - the LD (HL),n command. 

You may wonder, looking at the table, how you can load for example 
the contents of Register D into an address pointed to by Register 
pair BC - that is, how do you cope without a command LD (BC),D. 
| Well, good Register management, in the first place. But that isn t 
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always feasible, 
(having first 'saved' 
A, D; then simply use 


So you'll have to transfer the data in D to ^ 

A somewhere, if Y° u want to keep it} ' usin 9 l h 
LD (BC) r A • 


y 

i 

V 

r ^ 

i 

r* 


Four commands missing from the Table which 
but will not be required for a while are:- 


were discussed earlier 


LD A,I (load A from the Interrupt Register) 
LD A,R (load A from the Refresh Register) 

LD I,A (Load Interrupt Register from A) 

LD R,A (load Refresh Register from A) 



The basic format for 16-bit (two-byte) data loads is essentially 
the same as that for 8-bit loads, namely:- 


LD destination, source 

i 

There are however some important exceptions, which we will come to 
in a moment. Since we are talking about two-byte loads, either the 
source or the destination must, of course, be a Register pair. 

( 

f 

The following Table shows the commands available within the format 
'LD destination,source- 



-" ." V " * ^— - -——~-~— — ~• -—— 


Doesn't 
can^ - 

content 5 

ID B c ' DE 


look a very busy Table, does it? it would appear that you 
as an example - directly load Register pair BC from the 
of, say, Register DE. Appearances are correct: there is no 
command. But as we shall see, this isn't really a problem. 


in 


the 


Table, 


•nn' 


iuld 


address, 


of course represents two bytes of data - which 
simply a number for some arithmetical 


or 


U iw be an 

^oration - while '(nn)' represents the CONTENTS of address 'nn'. 


probably the most important things to notice about this table are 
the absence of the A Register in a pairing, and the fact that the 
Stack Pointer Register, SP, can be loaded from the contents of 
Register pair HL, or the two-byte Registers IX or IY, or with an 
immediate address -'nn', or from the contents of a specific address 
'( nn )'. So there are several ways to set up the Stack Pointer 
or even to change it during a program (as long as you know what 
you're doing). 


The reverse isn't true, however: as far as load - LD - commands are 
concerned, the SP address can only be loaded into '(nn)' - to save 
its value. 

Now, what about the other ways we have to transfer two bytes of 
data, and what about the poor old A Register? What the Table could 
have shown is an extra column and an extra row headed (SP) - that 
is, for example, a LD (SP),BC command, or a LD BC,(SP) command. 
These functions are possible - but they are not invoked by this type 
of command. 

Let's see what LD (SP),BC means. '(SP)' means the contents of the 
address 'named' in the Stack Pointer Register. That's the top of 
th e Stack. So 'LD (SP),BC' means - 'put the contents of Register 
Pair BC onto the Stack'. Similarly, 'LD BC,(SP)’ means - 'load 
Register pair BC from the contents at the top of the Stack'. In 
both instances, the address held in the Stack Pointer Register is 
'updated' after the transfer of each byte (see the earlier 
dl scussion on the Stack Pointer). 
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,. , its own to put the contents of a Register 

There is a command al ^ command to take two bytes off. The 

pair on the Stack, respectively, 

commands are PUSH and POP, 

n hwo bvte Registers you can PUSH and 
These are the Register pairs and two byte 

POP:- 

AF,BC,DE,HL,IX , IY 

. . DofI ict-p r nair DE on the Stack, you 

Thus, to store the contents of Register p . 

. ria-f-a a t- the top of the Stack into 

can write PUSH DE. And to get the data at tne p 

DE, you can write POP DE. 

You noticed, didn't you - Register pair AF can be PUSHed and POPed 
to and from the Stack. That's so you can conveniently put aside 
what may be important data in both' or either the A Register and the 
Flag Register. 

Now, what about that poser we set earlier - loading BC from DE, for 
example. How do we do that? There are two ways. One, you can PUSH 
DE, then POP BC - that puts DE's data on the Stack, then reads it 

B f h f . lnt r°n B c‘m Meth ° d tW ° ' USe the tW ° si "9le-byte load commands, LD 
B,D, LD C,E. Both methods work, both methods are exactly two 
instruction bytes long, both methods are used auite „ * 

But, the PUSH and POP method makes the Z80 look Z eXtSnS1Ve1 ^ 

into ram area to execute th * beyond ' itself and 

Hegister,Register method doesn't. ' Whereas the LD 

method is faster (by 16 T-States ? ^ LD Re 9ister,Register 

put the two byte data that's in on * bappens ) • If you want to 

^ t0 3 Register pair, then youV ^ Registe rs IX or IY 
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Th ere are some more commands that enable you to shift two bytes of 
data from one place to another. They are called 'Exchanges’. Here 
they are:- 


EX (SP),HL 
EX (SP),IX 
EX (SP),IY 
EX DE,HL 
EX AF, AF' 

EXX 

An Exchange is different from a load, in that the contents of both 
places designated are 'swapped'. Thus, the first three commands 
swap the contents at the top of the Stack with the respective 
Register named - HL,IX or IY. 

For example, when a subroutine is called (through a CALL command) 
the address of the next instruction after the CALL is put on the 
Stack. That's the address that will be put back into the Program 
Counter when a RETurn is made from the subroutine. But supposing we 
choose to put after the CALL command not the next instruction, but 
an item or items of data that we wish to pass into the subroutine. 
In the subroutine, we do an EX (SP),HL command. So now what was in 
HL is on the top of the Stack, and what was on the top of the Stack 
- the address of where our data is - is in HL. We can pick up the 
data now by doing, for example, a 'LD A,(HL)' command. Now - and 
this is important - we increment HL so that it points (or bumps ) 
over the information byte(s) to the address of the next instruction, 
and then do another EX (SP),HL. The correct address for the next 
instruction when we RETurn is now in the right place ready to be 
picked up by the Program Counter, and we've passed data into the 
subroutine for processing. That's by no means the only way to pass 
data into a subroutine, but it is a useful way. 

The EX DE,HL command is invaluable when doing arithmetical 
operations, or when you want to exchange a DEstination address in DE 
an< 3 a source address in HL. 


37 
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. h _ contents of the three Register pairs 
The EXX command cQUnterparts in the second Register set 

“'"f OE and HE'. But not, you'll notice, the AF Registers - they 
have their own command EX AF,AF 1 • The information contained in the 
second Register set is not worked on, merely 'held in abeyance so 
1 have another way of temporarily holding onto data without 
setting up storage addresses or using the Stack. However, you 11 
find in some computers, the second set is used quite extensively to 
handle interrupt routines and so on, so if you unwittingly wipe out 
or leave 'strange' data in the second set, you could have some 
peculiar things happening. 
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We now come to the commands which enable any number of data bytes 
t0 be transferred from one place in RAM memory to another. These 
commands and their functions are:- 

LDI - Load (DE) from (HL) 

Increment DE and HL 
Decrement BC 

LDIR - Load (DE) from (HL) 

Increment DE and HL 
Decrement BC 
Repeat until BC = 0 

LDD - Load (DE) from (HL) 

Decrement DE and HL 
Decrement BC 

LDDR - Load (DE) from (HL) 

Decrement DE and HL 
Decrement BC 
Repeat until BC = 0 


All of these commands transfer the data byte found at the address 
pointed to by the Register pair HL, to the address pointed to by the 
Register pair DE. After each data transfer the value held in 
Register pair BC is decremented. (Obviously, these three Register 
Pairs must therefore be 'primed' before the block transfer command 
is invoked). 

in the case of the LDI and LDIR commands, DE and HL are incremented 
a fter eabh transfer, while for the LDD and LDDR commands they are 
decremented after each transfer. Thus HL and DE are always left 
Pointing to the correct addresses for the next data byte transfer. 
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, the transfer of data continues 
rth the 10» - LDDR i:Thich' P oint Pressing continues with the 
Ztll B C becomes *•»' 

next command. sing continues with the next 

, fh the ua and LDD commands, enables other actions to be taken 
Wl nd after each transfer. though you must remember not to 

the next transfer of Jta^ (unless that is ail 

•upset' the values in t e • ^ LDI an d LDD commands set the P/v 

part Of your cunning program). ^ The followin g program 

Flag to aero if they tha t have their most significant 

will transfer only those aa fc he program assumes that 

bit (Bit 7) 'set' - that is, equaDestination and Source 'start’ 
DE and HL ^ ^ to count the maximum number of bytes 

m:::,::: r tlilerred if Bityisegual to,'. 


NEXT:LD 

A,(HL) 

;Get ’next* byte 

BIT 

7,A 

;Test top bit 

JR NZ,M0VE 

;Byte wanted - shift it 

INC 

HL 

;Byte unwanted - increment 

DEC 

BC 

; and decrement the counter 

TESTJLD 

A,B 

;Check if BC is zero 

OR 

C 

;by ORing B with C 

JR NZ,NEXT 

;Do it again if BC not zero 

JR 

DONE 

i BC is zero - so finish 

MOVE:LDI 


;Move the byte 

JP PE,NEXT 

;Do again if BC not zero 


DONE:Your next command... 


Instead of the 'jp pe next' 

relative jump back to the 'TEST ,man - ! ^ ^ LDI ’ 006 COUld d ° 
BC has reached 2er o after be a ' ^ ^ ' Which <*«*. 
demonstrate the use Of the'jp ^ deCremente <*- But we wanted 

Cann0t d ° a Native Jump (JR Lab N ° t6 ' inci <^"taU y , , 
this, and the o h L ! ^ Whe " testi "9 for pa rity . , 

er commands ’bit 7 a* TM n 

X1 '/A ,xnc and DEC lat< 

40 
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It is so 


10 * " ,ay 
that w« 


ask why do we need both LDIR and LDDR 
never 'overwrite' data we want to shift 


commands. 


nrt ee for example we want to shift" a Hat > 
suppose o shift a data block of 1001H bytes 

from 8000H to 8500H. we use the LDIR command with HL pointing to 

S000H and DE pointing to 8500H. the first byte will be transferred 

from 8000 to 8500H - overwriting data within the block of iooih 

b ytes we're going to transfer. 


in this instance, we would use the LDDR command - and set the HL 
Register to point to the END of the block we wish to shift (i.e. 
9000H)/ and DE to the END of the destination area (i.e. 9500H) . So 
now, by the time DE has been decremented to 9000H, we've already 
shifted the data from there, so it's o.k. to overwrite it. 


2. Data manipulation & test commands 

The 8-Bit Arithmetic and Logic Group 

The simplest arithmetical operation that can be done on a single 
byte is to add one to it (INC) or deduct one from it (DEC). These 
operations can be performed on the following Registers and addresses 
pointed to by Registers 

A, B, C, D, E, H, L, (HL), (IX+d), (IY+d) 

The Z, P/v and S Flags are affected as a result of the operation. 

The rest of the operations in this section ALL operate on Register 
Ai the OTHER data byte source - even if that is Register A as well, 
m ust be specified. The following sources can be used for the 
other' data byte:- 

A, B, C, D, H, L, (HL), <IX + d), (IYfd), n 
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The * n' of course represents a specific value. 

The commands available areJ- 

ADD A; ADC A; SUB; SBC; AND; OR; XOR; CP 
We will examine each command:- 

ADDA (examples - ADD A,B; ADD A , (HL) ; ADD A 2) 

Note the A Register must be specified Thi ' 

specified data byte to that in Register A T( , C ° mmand sim P ^ adds th* 
the contents of the address - Thus ADD A, (HL, raeans 

A Register, l eaving the r6sult to ^ HL to the contents of th 

exceeds FF hex ,255 decimal), the carrvV RS9iSter - « the result 
result minus 256. Thus, with PF . V Flag is s «t, and A holds th 
result in A holding a d .. X ln Re 9ister A 'add a 2' 6 

' d the c arry Fi ag sefc to , 1 , A ' 2 w °uld 

The *. P/V and s Flags are a, 

the ADD operation. S ° affected according to the result of 

~ c 4 (examples - adc a r 

is exactly the :: m DCA ' (HL, '- ADCA - 2 ) 

contents of the Carry r • 6 ^ the ADD comm and, except 

^-arry Register before «-u except that the 

ISO added to Register A. Thus if ,1 ° Peration commences are 
egister A holds 21 hex, 'adc a ,v results 6 Flag is se t and 

C r: the ° Perati ° n did not r gui 8 S . ln A h ° lding 2 < hex, and, 

would be reset to zero. 3 Ca «y', the Carry Fla 


SUB (examples - SUB B; SUB,(HL); SUB 2, 

Note that Register A is not specified 

r.e. subtract the contents of a f (un less one wants t 

specified data from Register A anH ^ subt * 

As with 'add* t-hm pi r anc ^ leaves the su btract 

• ». n.„ 1. 

the result. 
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5S _ SBC B; SBC (HL); SBC 2) 


si^ lar 

Flag 


/example 5 

SUB command, except that the contents of the Carry 
Iso subtracted from Register A. 


to the 
are al 


aN D (examples 
^s pertorms 
s p e ci£ ied data 


- AND A; AND (HL); AND OFH) 
a logic AND function between the A Register and the 
byte, leaving the result in Register A. 


i A NDi n g' means 

, then 
a '• , 

Otherwise it s 


'compare the two bytes, 
the corresponding bit 

•O' ' . 


bit by bit. If both bits are 
of the result will be a 1 1 • 


Thus with 0A7H in Register A, 'AND OFH' produces:- 


10100111 
00001111 
Result = 00000111 


(A7 hex, 167 decimal) 
(OF hex, 15 decimal) 
(7) 


This technique is often used to provide a 'mask' - that is, uo 
eliminate parts of a byte that are not wanted. The 'masking 1 data 
- in the above example 'OFH' - covers that part of the data byte we 

want to keep. 

. /-._ rrv piaq to zero. Thus AND A will reset 

ANDing always resets the Carry r iag 

Rpaister A as it was before the 
the Carry Flag to zero, and leave Regis 

-a /war, fhorpfnre be used to clear the Carry 
operation: this command can thererore 

Flag without upsetting Register A. 


OR (examples - OR A, OR (HL), OR 80H) 

This performs a logic OR function on the A Regist , 
result in the A Register. 


leaving the 


ORing' means 'test the two data bytes, bit y 
bits are a '1', then the corresponding bit in 

b e a '1'. Otherwise it's a 'O' 


. If either or 
the result will 
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Thus with ID hex in Register A, OR 80H produces. 


00011011 (1BH, 27 decimal) 

10000000 (80H, 128 decimal) 

Result = 10011011 (9BH, 155 decimal) 


This can be a useful way to add in bits to a byte: if A 
holds a value between 0 and 9, OR 30H will leave in 
code for that number. 


f ° r exa n»pl 6 
A the AScij 


OR always clears the 
according to the result, 
clears the Carry Flag. 


Carry Flag, and affects the other P1 
Thus, OR A leaves Register A unchanged, ^ 


~ 'samples - XOR A, XOR (HL>, XOR 0PH) 

is performs a logic XOR function on the A R • 
result in the A Register. Register, leaving the 

XORing' means 'conmar^ +-k . 

' and the other is a 'o', thin ^ ** ^ lf one « a 

Wil1 be set to a otherwise it nTT"" 9 bit of the result 

A holds 14H, then XOR 17H produces:- 6 °' '' ThUS lf Register 

00010100 (14H, 20 decimal) 

00010111 (17H, 23 decimal) 

Result = 00000011 ( 3 ) 

XOR always resets the Carry Flag, an d „ 

according to the result. XOR A must always resell ° ther ^ 
becoming zero - thus this is a useful command to clelr" I 

and the Carry Flag to zero: the Zero Flag willb J 

“ meanin g th & value of Register A is zero. S S6t t0 
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(e* a 


mP le 


s - 


^'' s ubWacts 

,n ter * ' 

^ected by the 


CP B, CP (HL), CP 9) 
the specified data byte 
AND DISCARDS THE RESULT: 
command. 


from the value held in 
thus, only the Flags are 


Test byte is greater than that in Register A, then the Carry 


if the «. 

1 W ill be set 


flag 


the test byte is the 

Flag be S6t - 


same as that in Register A, 


then the Zero 


jf the test byte is equal to or less than that in Register A, then 
the Carry Flag is reset. 


The Sign Flag and the P/V Flags will be set or reset according to 
the value in Register A. 


ThP 16-Bit Arithmetic & Logic Group 

As with the 8-bit Group, the simplest commands in this Group are 
INC and DEC. These commands can be used to increment or decrement 
Register pairs 

BC, DE, HL 

and the 16-bit Registers:- 
SP, IX, IY 

Note however that, unlike the 8-bit INC and DEC, for the 16-bit 
er sions, the Flags are completely unaffected. 

’ he following Table shows the ADD, ADC and SBC commands available 
Seated by the x 1 s): - 
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This 

pair 


with 

BC DE HL SP IX IY 


ADD HL 
ADD IX 
ADD IY 
ADC HL 
SBC HL 


X X X x 

XX XX 

XX X X 

X X X X 


X X X X 


Note that the SUB command is 
always involved on a subtract 
Carry Flag involved - in case it 
command first to clear it. 


not available - 
operation. If 
may be set to 


the Carry Flag is 

you don't want th e 
1 / use an or a 


The add. 


* nd SBC Actions are the same as those f u 

~ ° £ — -ev are operating 7 n u-bS 


" o- 


T he 8 Bit Shifts and Rotate 

These commands operate on a specified byte of inf 

or rotating its contents 'to the left' or 'to .. atl ° n ' shif ti"9 

u or to the right'. 

The byte operated on can be in:- 


A, B, C, D 


E ' H / L, (HL) 


(IX+d), {IY+d) 


The commands available are as follows 

RLC (Examples - rlc B; rlc (HL) ) 

This moves the contents of bit 0 to bit 1, bit 1 t 

Bit 7 is moved into the Carry Flag and into bit n ° 2 Md 30 ° n ’ 

ROTATED Left, With the carry Flag refle t- ^ data is thUS 

Register A the command can be written RLC A 109 ^ N ° te ' f0t 

different command, requiring one less instructicm RLCA '" RLCA 1S ‘ 

u hyte. 

46 
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(ex* 


impl eS 


_ RRC B; RRC (HL) ) 

the contents of bit 7 to bit 6, bit 6 to bit 5 and so on 
: bit 0 are moved into tho 


^ moves —- - -r w to Dlt 5 and 

t# ‘ -tents Of bit 0 are moved into the Carry Fla, AND bit 7. The 
, thus ROTATED Right, with the Carry Flag reflecting bit 0. 
. ..ulster A, the command can be written RRC A or RRCA: RRCA 

• tror r i a r i. L a 


'"‘a is thuS 

^ Re gister A, - —. —<-an ue w 

P te shorter, faster version of the two. 
the sno 


J& 


(ex 


amples - RL B » RL ^ HL ) ) 


This 


moves 


the 


contents of bit 0 to bit 1 , bit 1 to bit 2 and so on. 


t 7 xs moved into the Carry Flag, and the Carry Flag contents are 
n Thu s nine bits are involved in a ROTATE Left. 


v 7 iS 

iV6 d into bit 0. - 

that for the A Register this command can be written RLA instead 
rLA being a shorter, faster command. 


00 ' 
note 
of R L A 


rr (examples RR B; RR (HL) ) 

This moves the contents of the Carry Flag into bit 7, bit 7 into bit 
6 and so on. Bit 0 is moved into the Carry Flag. Thus nine bits 
c are involved in a ROTATE Right. For the A Register, the command can 
be written RRA instead of RR A, RRA being the shorter and faster of 
the two commands. 


SLA (examples - SLA B; SLA (HL) ) 

This moves bit 0 into bit 1 , bit 1 into bit 2, and so on. Bit 7 is 

moved into the Carry Flag. A 'O' is placed in bit 0. Thus the data 

is SHIFTED left. 

(examples - SRA B? SRA (HL) ) 

Tfl is moves bit 7 into bit 6, bit 6 into bit 5 and so on. Bit 0 is 
*** into the Carry Flag. Bit 7 is ’refilled' with its original 

Value (this is for ’signed’ arithmetic' operations, to preserve the 

8i9nbi t 7). Thus the data is SHIFTED right, arithmetically. 
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Bit 0 is 


SRL (examples - SRL B; SRL (HL) ) , . „ -i ~ m 

moves bit 7 to bit 6, bit 6 to bit 5 and so on. Bit 0 is move,) 

into the Carry Flag, and a 'O' is placed in bit 7. Thus the data i s 
SHIFTED right. 


Decimal Arithmetic Rotates 

We now come to two very special rotate functions, used when 
handling Binary Coded Decimal Arithmetic. Both commands operate 
between Register A, and the data byte in the address pointed to by 
the Register pair HL (i.e. '(HL)'). They are:- 

RLD 

This command puts the bottom nibble (lower four bytes) of the j 
Register into the bottom nibble of (HL), the bottom nibble of (hli 
into the top nibble of (HL), and the top nibble of (HL) into the 
ower nibble of Register A. The nibbles are thus rotated. The tot, 
nibble of Register A is unaffected by the operation. 

RRD 

This does the same as RLD, but in the 

bottom nibble of Register A is moved to the" if 10 "' Thus ' the 
top nibble of (HL, is moved to the h 16 ° f (HL >' the 

bottom nibble of ,hl) is moved . ° *° m nibble of (HL) and the 

~ “ ‘ 
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often, ° ne wants to test a specific bit 
»*'* r it' s a M ' or a E <3^n y it can 3 data byte ' 

** t0 set a specific bit to a or reset ' V ” y —*»1 to 

,<!todo«is. 

basic command words available are- 

tbtee 


BIT b,l! Test bit 'b' at location '1' 

SET b,l: Set bit 'b' at location '1' to a '1' 
RES b,l: Reset bit 'b' at location * 1' to a 'O' 


bit 'b' can, of course, be any bit from 0 to 7. (Remember that 

^ i is the most significant, and bit 0 is the least significant), 
bit / 

location * 1 * can be any of the following 


A, B, C, D, E, H, L, (HL), (IX+d), (IY+d) 


Thus there are three basic commands, each of which can operate on 
one of eight bits in ten different locations - a total of 240 
commands in all. Typical examples of the three basic commands are 

now given. 


BIT 3,B 

This tests whether bit 3 of Register B is a 'O' or a '1' 


If it is a 


'O', the Zero Flag is set to a ' 1 ' so that a subsequent test for 
z ero would succeed. Thus, in this program segment:- 


BIT 3,B 
JP Z, WAS ZERO 


WlU ba made to the program segment H-U- £ 

lister B is 'O'. Otherwise, processing c 

anmand. 
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■ specifically set or reset by bi t 
. ... t the 2et° Flag Pflr itv/Overflow Flag 'P/V ma y 

NOte T 2 Sign Flag 'S' . and o j; tion they contain is irrelevant 

r« - - -.«“*«■»•» 

, n ^ The Carry 

and untestable. held value. 


,.i 11 contain 


7,( — hit 7 of the data byte at 

This command makes bit 7 or 

by the HL Register pair equal to a 


the address pointed to 


res 5 f (ix+3j _ address pointed to by 

This command operates on the data byte a Y 

the IX Register PLUS 3, resetting its bit 5 to a ’O' . Thus if the 

IX Register holds '8000H', then the data byte at address '8003H' 

will have its bit 5 turned into a 'O'. 




These bit manipulation functions can prove 
of program. To give just one broad example, in an Adventure game 
one data byte may be used to indicate the possible exits from a 
given location - a 'O' meaning 'no exit', and a '1' meaning 'exit 
possible'. Bit 7 could represent North, bit 6 East and so on, with 

' left ° ver ' t0 represent say 'up', 'down' and two other 

“ Pl H ~ jrrcr or not - - 

status ° £ an exit u a -tt- 0 ; re ^::r 0 r:; se :i:n:. the 
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s Pecifi cally on Register 
are a s follows:- 


ar e five instructions which operate 
“ he Carry Flag in Register F. These 

° n 




very special command 


<»>. - boo. . ;; u - r 

^ eci-al digit: thus one byte can stone two decimal digit ^ 
^ eferr ed to as 'Packed BCD-,. The values to ,, 5 , 

„ all he represented wrthrn one nibble: however, f or BCD we only 
nt oae decimal digit per nibble, and so the binary representations 
o '15' decimal are meaningless and not wanted. 


of 


'll' t0 


Let us i° ok at two exam P les * First, we will add '22' decimal to 
143 ' decimal. The program to do this in Binary Coded decimal could 

be:- 


LD A,22H;22H = 0010 0010 binary,'22' in BCD 
ADD A,43H;43H = 0100 0011 binary, , 43 l in BCD 


As you can see, adding the binary values would yield 0110 0101 

-which in BCD is '65'. Just what we wanted, so there's no problem. 
Now let us look at what happens if we add '26' decimal to '17' 
decimal. Using the program segment as before, the binary 
representation for this would be:- 


, 0010 0110 (26H) 

0001 0111 (17H) 

if we add these, we get 

°011 1101 (3DH) 

Here m, 

r ^de 6 ^ meaningless as a decimal number. And that, patient 

iost r ' * S w ^ ere the DAA command comes in. Added after the ADD A 
* 0n in the program above, it Decimal Adjusts any result 
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t e^ple- the W 
in the fit st * But in the second exam w 
gtJlS ter. T ^ S ' s fJ ne and dandy. ^ th> lowe r nibble, , * 

tl,e * nJ for a11 have 9 one wr 9 „n whether we’d b 

do nothin thing s hav (depe nding on w D % 

lt would see gone wrong < ult accordingly. I„ t 

what adiust tne n1 nn 0011 - * a. 


*»»"• things have di „, on —— -- ■ 

juld "* ‘ hat had gone wr°n9 ‘ uit accordingly. I„ t 

get bt ; ung). end -J- „ A ho lding 0100 0011 

adding o' su *“ wou id leave Beg this specific instance j. 

— 'Z which is «*“' ; ther s to the lower nibble, 

"is — * to know that it m akes 

don't worry shout that. 

correct adjustment. 






correct adjustment. 

k however, Is that to sort things out the ^! 

what you should Know, ho _ ^ a£ter a DAA command, ali ^ 

command makes use of 
Flags are affected in some way. 


Cpl , , 

Ms command 'complements' whatever value is held in the A Register. 

that is, every 'O' becomes a '1', and every '1' becomes a 'O'. Thus,! 

if the A Register held the binary value '00101 100', after 


command it would hold the binary value '11010011'. 


CPL 


This is called the 'one's complement' of the number, and is a way of 


representing positive and negative values. For example, a '5 


in 


binary is represented by '00000101'. On the other hand '-5' can be 

represented by the 'one' s complement' , namely ' 1111 1 01 0 ' . NoHr ! 

that bit 7 is now ' 1 ' - representing a minus value. (See also t-h 
discussion on Flags). wee also the 


The 'testable Flags are not affected. 


NEG 


In thl s command, the p n 

^d a t h ? w; uiting - 1 - ^VoLr^rLY" subtracte 

s complement' of t-u ln Re 9ister a. T 

or the number. 
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comple"' ent representation, p ositlve 

in 'on 6 ' 5 =°'"P lement ' - i-e. in the usual represe "ted 

1 showing the sign <0„positi ve n Sl «ned binary way, 

wit" ho wever are represented as the 'one's" e94tlve) ' Negative 

,<us the tw °' s complement of '-5' is 'ini°on'” ent ' Value PLUS 
0* e ' 


to all UUP — 
uny y f(jr t he computer 

ea s ier 

00000011 (+3) 


this bother? Two's complement makes 
i computer to handle. Consider th gned arithmeti< 

e Sum '3 minus 5 '. 


11111011 (-5) 


&dd ing 


these (since we are representing the ' • 


ment)» we 9 e t • 


minus' as -5 in two's 


11111110 


Here, blt 7 tells us the answer is negative. Taking the two's 
conplemant of 1111110 , therefore, we get 00000010 (two's complement 

remember, is the one's complement of 1111110, which is 0000001 olui 
Thus, the value is '2', and the Sian Is ... 


Jus t what the doctor ordered, 


Lgn is negative. Answer, -2. 


Ihe Z80 command NEC, then, obtains the two's complement of a value 
in Register A and leaves it in Register A, thus saving the bother of 
doing a one's complement (CPL) and adding 1 (ADD A,1). This is a 
very scant description of the principles behind one's and two's 
complement arithmetic, but it should be enough to give the newcomer 
to machine coding an idea of what it's all about. 

Note that all the Flags may be affected by NEG command. 


This command 'complements' the Carry Flag in the F Register. If the 
Carry Fi ag i s 'o', then CCF makes it a '1'. If the Carry Flag is 
^ ? CCF makes it 'O'. 


Scanned by CamScanne 


as c 

i'). 


nd 

cc ***** 


r, equal to 

he carry ? lag 

the U<1 


1 


(i.e. ' Se ^ 


t 


C *rJ 

/ 


r 


M 


. ,„• »•»" r ;r »T ini - 

„. t a c^ d l ° ti0 Z before, ^ J ^ars the Carry Fla g ^ 

* isn r as * ent „ else. x0R t() , _ a nd consequents 

; 0Ut but also clears ^ possrbly g mlght see that S; 

o - - Te—>• wouia be to t set tvs 

lects^ 7 ' r to clear the Carry this takes two bytes of 

"Ten Z*~* ^TU — 8011,8 ^ " UCh 90 ° a 

— coae.-^ spQtted a nyway. 


as 


UCtlU ' 1 -- 

ternative. But 


f 

I, 

j 

I- 


I 

1 

I 

f 

f 
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^jY _rOMPARISONS 

The last ’manipulation and t 
iBlock comparisons’. ln ***' ^ands t 

, Block transfer’ commands » ^Pects thes •*“*»« are the 

ch unK of data to be 'searched' to 6arl ‘*r. * Si " U « to the 
that in Register A. Li ke thfi nd a byte th#t J •“ bl « a whole 

-- "" the Re 9isters first: HL u^" 3 ^ '°">ma„ ds , * SMe as 

ched, BC with t-h ^ start ' 6y need you 

with the number of w 1 addr ess of fh. 

lata byte we're f ^ytes to h the area 

we re looking for mL co be search** . 


to set up the Registers f irst: HL com mands , * Sarae as 

„ M searched, BC J »• eta,, ~ 

.... »•«»-— 

CPI Increment HL 


Increment HL 
Decrement BC 


CPD Decrement HL 
Decrement BC 


CPIR Increment HL 
Decrement BC 

Continue until BC=0 or A=(HL) 

CPDR Decrement HL 
Decrement BC 

Continue until BC=0 or A= (HL) 


As with the block transfers, the CPI and CPD commands enable other 
operations to be undertaken within the 'search loop . When a match 
is found, the Zero Flag is set. When BC reaches zero, the P/v Flag 

becomes 0 (Reset). 


The CPIR and CPDR commands whiz through the block 
until BC reaches zero, or a match is found. 


When a match is found, 
bo the matching byte in 


of course. Register pair 
the data block. 


HL will be pointing 
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#m running *«» uencC | 

O .rou‘ inflpr09ra *s which let you Change the ’ba tt > 

3- B *' the command commands which emulate h* 

r: course,RETURN '' Inraac S 

;UB ' S ^ m nre scope- 


no» c0,ne 

0 ^' 0t „ or e scope- 

V\t"Lr. have 



jum£§. 

be emulated by a JumP (JP) 
instruction can ^ uke . straight GOTO. 

A straight 


o r 




. , or J p addreSS 

j P Label 01 

the label you have given at 4 

been defined y 

, that is, any of the Flags can b. 
Jumps can also be condition. succeeds . The format for thl s 

tested, and the Jump made if 


I 

be tested 


JP cc, Label or JP cc,address 

,ere cc represents any of the Flag conditions that can 
:.g. NZ,Z,NC,C,PO,PE,P,M - see the section on 'Flags ). Thus a 
pical instruction might be JP NZ,ENDGAME, which means 'if the Zero 
ag is not set (non zero condition) - 3S a result of a previous 
>eration - then continue processing from the address labelled 
IDGAME' . 


Relative jumps need a little explaining. Their instruction co 
are shorter than straight jumps. The address they provide a jump 
is relative to the current address, and is given by a displaces 

Instruct COn T ntlY ^ a ° tUal addleSS d ° eSn,t *i9»re in 

Itself. If none of the addresses within 
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. itself are 'mentioned 
i.n e 


tine — directly f . 

■V* in mem ° ry -., “ 18 th « CUM ‘ he , rOU “- can be located 

’ L prog rammer ® w “ te sma U subroutines , to relloc atabl e ' routine 

rcuocatab e for., so that they c ° ° S ^«ic functions', 

. t program they are preparing. A11 the routines to any 

»t <>* thS r ° Utlne ' " hich ia ^ne by a Lbe! ^ iS the 


Th e 


,rmat f or a relative jump is;_ 

JR Label or jr sc,Label 


„ et e ' sc ' represents a conditional test 

'sst any of the Flags, only the Zero and cLT^*' “ hiCh 

3 conditional relative jumD _ • Y ags can be tested 

for ^ v ~ i .e. z m? p 

n not write, for example 'jr M, LABEL'. ' ' or Nc - So you 

ca * 


The relative jump can be made forwards or backw a 
displacement value is in two's complement, and is add d't ^ 
progra „ Counter plus 2. If ■ you work u ^ f ‘° ““ 

relative lumps can be made to addresses within - 12 6 and r ,2 b es 
o£ the address of he first byte of the 'jr' instruct 0 

fortunately, the Assembler calculates the displacement value for you 
when generating the machine code. Y 


s pecial Jumps 

There are four more kinds of jump you can do in machine coding. 

Three of these enable you to jump to an address specified in the 
Registers. They are:- 

JP (HL) 

JP (IX) 

JP (IY) 

and they're extremely useful when using 'jump tables'. One could 
for example have a data table of items, each item being three bytes 
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long. The first byte of each item would be the • ? 

The next two bytes would be the address (i n the or 6 S6l ®ct 

byte, remember) of the 'action' routine for that^^ L ° W byte °*'*1 
•menu selectors' through the table are searched m6nU 
next two bytes of the item where no match is f 6 (jumpin 9 ov e 
found. ° Und) unt il a mat * 


With HL pointing to the matching byte, it io ., ' 

to: INC HL (so It points to the Low Byte of the ant- Slmple «»t. I 

'ick up the low byte in E; INC HL - pointT address >; *' 
__ . t^oint to ... ' 

b Yt* 

I 


E,(HL) 

of the action address); 


Put 


4, 


—v. — auuress ) ; LD D,(HL) - nirk < + ^ «: 

address into HL; JP (HL) - and go. P! EX DE,HL - 

This procedure is just one of the menu 

Pi ° k “ P the addre - ° £ a required routine ^ c ‘ 

"ay, but it demonstrates a point. ‘ ItSalso a f airly c *»i 

The fourth kind of jump emulates to som f 

l " MSIC - « is a type of Helat ve a “ t “ t the , ! 

^ "“P' and has the format ^ H ; 

°JNZ Label 

* thls instruction Register b • 1 

Set ifc -P with a value ^ 35 a <=°unter 

operation done. At th “ 6<5Ual to the nu mber of . . ’ S ° yo “ mu st i 

“hen the djnz command ■ e9l " nln9 o£ the ■ i co , lmSS you "ant the 

iS " 0t »» as a " t lS mPt ' Register b £*’ ^ hav * a Labe,. 

a Re£ ative Jump, so ' 3 3um P ™ade to the ® Pemented and, „ u ' 

bnes a£ the w NZ i 6 Ubel add «ss must^h ' addfess - It i s 
the disci*. instruction's ^ be wi thi n >1, 

Placement f or yog) _ address (the Ass 126 a hd *,j, 

UAer calcul'*-*- 

You - 


can 


succeeds, ^ P e rh ° Ut ° f the loop a t a 
° Pera tions left to'd R69iSter B win the^K ' ^ * Subsi <*iary 

- «hich may be u 
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A 'CALL' command i s j Ust t 

^and, it can be uncondition^^ 08116 ' In 


basic. 


CALL Label or 


Lik ® the 


conditional: - 


CALL a aa ress 


jump 


CALL cc,Label 

CALL cc 

Cc raddress 


the ' cc ' ^presenting one of 

conditional Jump command. he P1 ag test* 

s » just ac * 

as for the 

When a CALL command is met, the 

cOT »and is put on the stack," add «ss tor th 

discussed this when revie„ lng th , [ ^ “**" a RETurn ls 
therefore ensure that the stack stn ! ° £ the 280. ¥n ' 

top' when the RETurn is made (it ., ^urn addr??! 

er lf you don’t). 

Restore 

There is another kind of special Cal] 
stands for ReSTore. The format is:- C °"“ , ' a ' ,d ' Called RST - which 


RST a 


°°H. 08H, 10H, 18H, 20H, 28H, 30H or 38H. 

When the pom 

« on the stack"T 1' the ^ a » Counter address is 

the specified add aS ln a CALL co “ and >' » Jump is made to 

U °"iy one byte l!n!’ T* ab ° Ut tMS lnstruction ls that 

long, and provides an extremely fast jump. 
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You'll notice though that all the addresses concerned lie with* 

ROM area. So, for example, RST 00H gives you a cold start ^ \ 
pressing 'reset', if your MSX has one. The other addresses 
-jumps to specific routines used by MSX Basic, getting the N* 
character in a Basic line of text, for slot management, ^ 
outputting to a currently operative device, and so on. ’ S 


Returns 

These RETurn control from a subroutine, just like 'RETURN• 
BASIC. The format is:- 


RET or RET cc 

where 'cc' is one of the Flag tests, as for the jump (JP) and 
commands. 


There are two special Return commands. The first is RETI (return 
from an interrupt), which must always be preceded by an El (Enable 
Interrupt) command. The second is RETN, which provides a return 
from a non-maskable interrupt, and resets the Z80's interrupt Fl ag 
to the condition it held before the non-maskable interrupt was made 
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|nP ut/° utput cornrr >anda 

_ are a number c 


l 

are a number Q f „ 

<W ete . , . ° mn »anrt D 

uts to peripheral devices. d av au a 

‘’“"lock transfer commands, ' in *" n,a >>y w ay s ble ‘or i„ P(1 . , 

■ri-**- ei r ^ 

V - Ctl ° nS - TheSe a W C; « 

S are:. Perf orm ing 

Input commands 

INI ° Utput Amends 

OUTl 


o^ e 


INIR 

IND 

INDR 


OTir 

OUTD 

OTDR 


t he i n P ut commands, the peripheral d 
[1 .read', and the information is b * *9Lu, 

w Register pair HL. Then ° tha address point., 

Fe , lSt er pair HL incremented ,m. INIR) or 

commands, the procedure i s reversed 
address pointed to by HL is output to l hat the 

, , ...... to the Derinhavoi 


F or 


the 


content 

device 

increme 


For 


Output commands, the procedure it; r- Q , 

° reversed - thaf 

5 of the address pointed to by HL is output t .. the 

addressed by Register c, B bei„ g decries ITTl 
ited or decremented after each transfer. 

the input or output commands ending with V, the procedure 
- until B = 0. 


continues apace 


Four 


other input and output commands are available. These are:- 
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Input commands 
IN A,(p) 

IN r,(C) 


Output commands 
OUT (p),A 
OUT (C),r 


M A, (p) loads Register A with a byte of data rea ^ A 

Peripheral Port V. Similarly, OUT <p),A outputs the 
| to the port ' p' . 
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IN r, (C) and OUT (C),r do the same kind 
device is addressed by the C Register, 

'r' can be any of:- 


°f thing, except 
and the specific 


Re gi 




A, B, c, D, E, H, L 


5. System controls 


ines e commands 






^uLiuuing 


NOP 


'—*ii 


TWS "' eans ' sinpiy, No op 

on with the no vf_ . nation. 


— th. „e xt ">.t is, do nothlng> 

—* takes l a suitabie — ^ 

very short - - - - 


This shuts down fh^ 

interrupt i s re . ° perati on of the Z fin 

ls recexved, or a 'reset, Z8 ° ^Pletely 

reset Performed. V ' Un ti: 

DlxEl 

TheSe Disable or E n k, 

discussed in th a e the Interrunt- 

6 Secfc ion on the Z8 0 » Pr ° Ce dure s . 

80 Registers, ln terrupt, 

J he IM commands set th 

dlScuss ion on Inf 280 a Par t • 

I nterrupt<5 P ar ticui ar 

■ ,h< - 
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280 


s ?$v 



gOMMANDSj-Pseudo Opsj 


uS ^ n g an Assembler, you’ll find other commands are available 

essential for writing in Assembly Language. These are 

by the Assembler to tell it what to do - reserve data space, 

US€ .u at a specific address and so on. They do not 'translate* 

vrO instruction codes, and will not normally appear in a 
into ^ 

ssembled listing. Please refer to the manual for your 
1 emblem for details of these commands. 






'tit- 


“her, 


104 for, 




► be used ts- 



f 
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Using 


ZEN Assembler 


... deal with getting started on writing your 0Wn 
This chapter wil . Assembler/editor program such as z En 

:;r: s all MSX home computers. 

entering programs between ZEN and other 

^ mbler^should be minimal as the principles are the same If y 0u 
assemblers entering lines into an assembler then 

tr* roh^obviously could be skipped as «e Will Stan 
from loading the assembler and describe some of the errors which ca„ 
too easily be made by first time users. The first program we wi U 
enter simply prints the alphabet along one screen line, which is not 
very exciting, but it is nice and short and will demonstrate how 

lines are entered. 

The ROM section of memory (addresses between 0000 and 8000 hex. 
Within the MSX not only contains the Basic Interpreter but routines 
for carrying out tasks for what are simply termed as housekeeping 
gobs, as were used in chapter 1. These routines take care of tasks 
such as printing a character on screen, printing a new line, 

accessing the clock, using the PSG chip, reading a program from 
tape, verifying and saving of programs etc., and obviously they are 
made full use of when running any program, Basic or machine code as 
it is far simpler to form a message to be printed from within your 
program and then simply call the ROM routine to get that message 
printed on the screen than writing a routine in your program to do 
the same job. 

ZEN loads into RAM at A000 hex this is why one is instructed to 
enter CLEAR200,&H9FFF before BLOAD"ZEN",R is entered. 
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* 


on completion the screen will dlsplay:- 
ZEN > 


% 

*> s , N 
N; 


Enter exdctly f spaces includi^H i i . 

aed ' ail entries under the TO ENTER 

CO umn NOT THE DISPLAYED COLUMN) followed by the 'RETURN' key at 

the end of each line. There is an error in the program which has 
been entered deliberately and we will alter it later. Remember any 
calls or jumps to addresses between 0000H and 8000H are to routines 
within the ROM section, and their functions will be described. 


*D<} 


TO 

^V- 

! “ill J 

DISPLAYED 

ENTER 

ZEN > 

E 

c. 

1 

LOOP:EQU 0A003H 

S “kief.. 

K 

2 

CALL 0849H 

rai » We r 

3 

LD A,"A" 

hi =l> i S .‘ 

4 

NEXT:CALLOOA2H 

ls trate ; 

5 

INC A 


6 

CP "z"+i 


7 

JR NZ,NEXT 

3000 k 

: routis 

8 

9 

LD A,ODH 

CALL 00A2H 


1 0 

LD A r OAH 

seJceepr 

11 

CALL 00A2H 

of ttf 

12 

JP LOOP 

iew li* 

13 

END 

fjraro **■ 

14 

• 

the y 

cote ; 

ZEN > 


ilfl 1* 

At the end of a program one must 
to cease entering and mov 
entered on a separate line 


• ,, analyse what has been entered. 
Now we will anaiy 
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assembler that the Label 'LOOP' equates to A003H which i s 
address we wish to jump to at the end of the program as one can 
in line 9 we have entered JP LOOP, we don't need to specif 

address to jump to as the assembler has noted which address 
One reason for these equates is that if we wished to 


equals . 


the address at some future stage we would not need to list the 
program and alter each line which contained this address, all 
is required is to change the first line to the different address 1 * 181 
the assembler will do the work for us. This address is the ^ 
start entry point to the ZEN Assembler, when this short pr *** 
finishes running we need to tell the computer where to jump to T' 
the mainloop of ZEN seems to be as good a place at this stage ^ 
don't want the program running off wildly into memory. * 


NOTE Whenever a hex number begins with a letter (A-F) a 

9 9 ds in 

this case, it must be prefixed with a zero as is shown in li ne i 
otherwise the Assembler could confuse it for a label which always 
start with an alpha letter. Secondly a colon must be entered 
between the label and the letters EQU. 


Line 2 calls a ROM routine at address 0849H which simply clears the 
screen and returns to our program. This is similar to a GOSUB in 
basic but in this case the subroutine is already in ROM and all our 
program needs to do is call it. 

Line 3 loads the A register with the value of the letter 'A'. ZEN 
is quite versatile in that it allows entries within quotes and it 
simply converts this to the Hex equivalent value of the letter, in 
fact this line would have the same meaning if we entered LD A,41H 
which is how it would be assembled and loaded into memory by ZEN 
anyway. 41Hex is the hexadecimal ASCII value for the letter 'A', or 
we could have entered LD A,65 which is the decimal ASCII value of 
the letter 'A' and so omitting the suffix H which signifies to ZEN 
that the value is decimal and ZEN must convert it to Hex. 
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4 c ° 


ntal is followed after the colon by CALL to 00A2H 

letters. _ m .. _u_4-ho ascii 


the label NEXT as we will jump back here to continue 

ins 


a subroutine in ROM which prints the ASCII 

again ^ 


o nce stored in register A, and returns to our program, 

currently 


ents register A so the first time round after printing 

1 ...» > • i » 4 _^ ^ I.I ill 


screen 


want it to increase its value by 1 , so it will 


-rease 


from 


41H to 42H, the letter 'B'. 


r-os the value of register A to see if it has reached Z + 
line hasn't line 7 tests and jumps back to NEXT to do it all 

j if it 

.. • noe-inr nnfnr* lino A ac ** 7. f * ^ 1 hll t Wh6n it 


again* 


once a 


gain it is easier to enter line 6 as "Z"+1 but when it 


o this will be automatically altered to the ASCII Hex 

sembiea 


value 


of Z plus 1 making 5B hex 


7 is the relative jump and here one can see the advantage of 


lines a label for one does not need to calculate the number 


iving “ - 

9 t es to jump back as the assembler does it for us. Furthermore 
^ oU id add extra lines between 4 and 7 which will obviously alter 
0116 amount of bytes to jump back over without the need to adjust 
anything else as the assembler will adjust the relative jump 
automatically providing the jump does not exceed -126 or +129. 


Line 8 is only reached when register A equals Z+1 , when the alphabet 
is completed, then line 8 loads register A with the ASCII code for a 
carriage return, which returns the cursor to the left most position 
on the line, and line 9 calls 00A2H again to print it. 


note ASCII codes below 20 hex are control characters, for 
positioning the cursor etc., and can be used with a call to 00A2 
as was done with the alphabet. 


Line 10 loads A with the ASCII code for a line feed (0A) as not only 
do we require the cursor to return to the left of the screen we also 
want it to move down to the next line, so a further call is made to 


in line 11 to carry out the task. 
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Line 12 puts us back under the control of ZEN when the prog fd 
finishes with a jump to Loop (A003H). 


The next task is to find out if we have entered the progr 

correctly, some bright sparks may have noticed some errors alread^ 

as one will get errors when entering and it is better to disco 

some of the more common types of error messages at this early *** 

Enter 'A' and 'RETURN', this tells ZEN „e wish to assemble^' 
program. e 

The screen will prompt for an 'OPTION' which will determine if 
to assemble to a printer 
external device, or by entering 'V 
assembled version, or if we just 
it will be assembled internally 
contains any errors, which is the 
'OPTION' prompt enter 'RETURN'. 


by entering 'p», or 'e' f or a 
for video to print on screen the 
enter the 'RETURN' key on its own 
only stopping at a line which 
fastest option. So after the 


The screen will display:- 
ORG i 

2 START:CALL 0849H 
ZEN > 


which simply means we did not enter the origin of the program, which 
is where in memory we want it to reside. This is obviously a major 
omission as the assembler must know where to place the program. 
Enter 'T' followed by 'RETURN' and the first line of the program 
will be displayed. 'T' is the target line you wish to be displayed, 
entering 'T4' would display line 4, whereas just entering 'T' on its 
own moves up to the first line. 


Entering 'E', as we did to begin entering the program, will let us 
enter extra program lines from the current line, which after 
entering T will be line 1, and as we enter these extra lines all 
the lines already in the program will simply shift up a line, the 
existing line 1 will remain intact but will now become line 2 etc. 
We should also enter a line to determine where we wish the program 
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•o 


^ ** A 


** V 




0 A \ 

% \i 
t- 


*U 


*1$ 

Q t... k 


6 ' 


°" >„' <t 

5 0*.. 'i 

*y \ 

9 Oh . n 


°« 1( ’ 
$ i. X 

N S e * 
> * % 

•v 

'* 

s 


Jrara, wh:; 
Jly a m 
>gram. 
e progs 
displays 


»<p' on# 


11 l etl 


ch 




to load into m „ 

. , memory once it ic 

i;:r: s a :: r ::: as the --r 1 ::; tw *—- — *, * 

* WU1 lMd *» the M r pl I: e -> “Us program as 


DISPLAYED 





lit# * 


itiet 

2 


ie 




A 


ZEN > 
1 
2 
3 

ZEN > 


ORG 0E000H 

load oeoooh 


Note the fun s t op to brinq us baoR 

nto command level. 


Entering 'T' and ‘RETURN* will rt< , 

1 ORG OEOOOH ls Play li ne 1: _ 


ZEN > 


Now entering * P16 • and . RETURN , 
through to the end of 


the n WlU llSt the Pr ° 9ra " f rom line 1 

'EOF’. If one entered 'P 8 ' only LTfirTe r diSPlayed as 

so if the whole program is to b ... " es would ba listed, 

followed by a value equal to or i 1S 6 ensure you enter 'p' 

Notice that the original lines • rger than, the last line number. 

9 inal lanes in memory have been moved up 2 lines. 


Once again enter 'a' and 'Rftmrm• * t ■> 

to 'OPTION' prompt to see if ° ° Wed *** RETUEN ' in response 
assemble. if oL e l t ^ U COrr6dt a " d will 

display:- Pr ° 9ra "' 3S Sh ° Wn U shou W atop and 

HUH? 

6 NEXT;CALLO 0A2H 
ZEN > 


Faced 


with 


mi thlS err ° r ° ne " 1USt lDOk at the line and discover the 

willV beCaUS ® th ® pr0 " pt ' HUH? ' does not tell us much, only this 
appen many times when writing your own programs. The line 
i0 °ks O.K. 


but the fault lies in the basic fact that we 


did not 
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enter a space between CALL and the address display ed with thf 

Enter 'N' and 'RETURN' and the line 
cursor to the right of the line of characters 


S impiy EX delete the characters from the right, by using the ' Bs , 

bac space hey as the cursor Keys are inoperative under ZEN, unt U 

. f-ho first zero after CALL and enter a spa Ce 

the cursor is over the first zero 

followed by 00A2H and 'RETURN'. 

The line should now look like this.- 


6 NEXT:CALL 00A2H 

Entering 'A' followed by 'RETURN' twice should result in no error 
message this time and the 'ZEN' prompt should be displayed almost 
immediately on the next line, which tells us that it assembled O.K. 
and is loaded into memory. 

Enter 'GE000H' followed by 'RETURN' and the screen will display:- 


BKPT > 

this is asking us to enter a breakpoint in the program, for if one 
is testing certain parts of a lengthy program it can be halted at a 
specified address in memory, and control will pass back to ZEN. 
This can be very useful as machine code programs run so quickly that 
it is very hard to keep track of them. 

In this case we do not want to enter a breakpoint, so in response to 
the 'BKPT' prompt enter the 'RETURN' key. 

The screen should clear and this display should appear 

ABCDEFGHIJKLMNOPQRSTUVWXYZ 
ZEN > 


Don't expect too much from your first machine code program, this w 
only to demonstrate the principles in entering code, but now we ha 
ost all the bugs it seems a good time to assemble the program or 
o see what has happened. Enter 'A' and 'RETURN' and th 
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% 


\ V 

* V 

\ 


% 


n 


*V 


6(3 


■I 




if 05 
^ at: 
:o 2jj 

y tk 

lse t: 


time when prompted f or . 0 „ 
result should be as follows:- 

PAGE 1 


ORG 0E000H 

load oeoooh 

LOOP: EQU 0A003H 
CALL 0849H 
LD A,"A" 
NEXT: CALL 00A2H 
INC A 
CP "Z"+1 
JR NZ,NEXT 
LD A,0DH 
CALL 00A2H 
LD A,OAH 
CALL 00A2H 
JP LOOP 
END 


enter 'v' and 'RETURN* and the 


E000 CD4908 
E003 3E41 
E005 CDA200 
E008 3C 
E009 FE5B 
E00B 20F8 
E00D 3E0D 
EOOF CDA200 
E01 2 3E0A 
E014 CDA200 
E017 C303A0 

ZEN> 


in the above program, due to its simplicity, „e did not document the 
unctrons of any lines but in a longer program it will 

o escri e certain parts of the programs. Comments can be included 

To add S “ Ply e " terin9 3 Semi - colon by the comment 

^ a comment to line 3 enter 'T3' and 'RETURN' followed by 

right R ™tT' T line 3 Sh ° Uld bS diSplayed wlth cursor to the 
right of the characters:- 

3 LOOP:EQU 0A000H 

add the following 

;JUMP ON END and'RETURN' 

This line when listed will now show the comments after the semi- 
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colon which will ^ 

"*■ ^Ginind one at a r i 

achieving. Unlike Baslc date what the line „ 

iine therefore if one r 4 * * ° WS entr * “> a single sc _ 

tay be entered with no instruct- " al space £ ° r comments a 

the comments, these will be used °"* ’T * Seml ; oolo '> followed ^ 

Jf one has a printer the SU sequent listings for cla ■ '* 

show the comment fields after'a^inst 1 *^" 9 t0 P ' f ° r prlnte f 1 wn' 

th : u vr wiu not - ---n: ^ ^ 

" — —— --r •»: 

Alterations and Additions 

If one followed and understood the instnmn 

try the following:- and how the y «°rk e <i 

Alter the program to print the alphabet from z down to A 
Change line 5 to LD A,"z" 

line 7 to DEC A 

line 8 to CP "a"-1 

This will initially load register A with letter Z and instead of 
incrementing in line 7 it will decrement, so the first time round 
the value in register A will reduce to the letter Y and so on. Line 
8 checks if has reached A-1 and if not loops back to print again. 


SCREEN MESSAGES 


One will almost certainly require messages and inputs to be printed 
on screen, and as this test program is short it is ideal for 
modifying quite simply. The first line after the Clear screen call 
is line 5, so enter 'T5' and 'RETURN* and line 5 will get 
displayed:- 

5 LD A,"Z" 

ZEN > 
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Entering E and 'RETURN' will now enable one to add lines to the 
program, and move the existing lines up in memory. 

TO 

DISPLAYED ENTER 

5 LD HL,MESG1 

6 CALL 6678H 

7 

ZEN > 

These new instructions are thus:- 

LD HL,MESG1 loads register pair HL with the address in memory of the 
start of a screen message which will have the label MESG1 assigned 
to it. CALL 6678H is a ROM routine which prints, at the cursors 
current position on screen, the message which starts at the address 
stored in HL. The message, as you will see below, also contains any 
control characters to move the cursor which can be entered before or 
after the quotes containing the string. Furthermore the message 
must terminate with the NOP code (0) which is used as the 'End of 
String' marker. 

The next job is to enter MESG1 into our program. List the program 
on screen to discover the last line number, as it is here we will 
place the string of characters in our message. END should appear as 
line 17, so enter ' T17' and 'RETURN' followed by ’E' and 'RETURN' 


DISPLAYED 


ENTER 


MESG1:DB"TEST",ODH,0AH,0 


[f your message was longer than can fit onto one line then finish 
-he first line of the message by adding the closing quotes and 
-ontinue the message on the following line making sure it commences 
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nter ' ,0* at the end of message, 
with 'DB"' and only en e ^ be asse mbled again, making g 

in order to run the P assemblin g to the screen it wi U 

no bugs have cr p ^ no £ printed in full to the right of 

seen that long message^ that message are entered j 

screen, however t h e screen. If the MESG1 1 


% 


iht> 


• u p bvtes rcpicas*“-*- ■< 'ii 

screen, howeV6r ^ Qn the ie ft of the screen. If the MESG1 ^ 

memory as wil ^ the display would actually cut off 

y/ 3 S GHtGicO a 

the comma following 'ODH' 


s ee n 
Un e 


the comma ... - as • GE 000H ' . It will be 

Running the program can be enter Qn the first 

that the screen clears and TEST getspn 

and the alphabet gets printed, in reverse order, on the follow^ 
line . one could have entered additional codes for line feeds ■«*,. 

to print further down the screen. 


, . i, a i nu we shall alter it further. 

Ensure your program lists as below, as we 


1 ORG 0E000H 

2 LOAD 0E000H 

3 LOOP:EQU 0A000H;JUMP ON END 

4 CALL 0849H 

5 LD HL,MESG1 

6 CALL 6678H 

7 LD A,"Z" 

8 NEXT .-CALL 00A2H 

9 DEC A 

7 0 CP "A"-l 

11 JR NZ ,NEXT 

12 LD A,ODH 

13 CALL 00A2H 

14 LD A f 0AH 

15 CALL 00A2H 

16 JP LOOP 

17 MESG1 :DB"TEST",ODH,0AH,0 

18 END 
EOF 
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USER INPUTS 1 



We will assume that we wish the user to , 
in order for the alphabet to ho lnPUt 3 " u " ber <ro '" 1 to 9 

exists within the ROM that win 3 \™ * 

to be pressed before continuino a P r ° 9 ram and wait for a key 

9 an< ^ can be utilised quite simply. 


Alter line 17 by entering 'T17' and 'RETURN 1 followed by 'N' and 
■RETURN to alter MESG1 . With the cursor to the right of the line 
delete back with the Backspace key to the start of the string and 
alter the line to the following:- 


17 MESG1 :DB" INPUT 1 to9" , OAH, ODH, 0 


We also need to change the program to accept an input from the 
keyboard between 1 and 9. Enter 'T7' and 'RETURN' followed by 'E' 
and RETURN'. 


TO 

DISPLAYED ENTER 


7 

TIMES:CALL 009FH 

8 

CP 31H 

9 

JR C,TIMES 

10 

CP 3AH 

11 

JR NC,TIMES 

12 

SUB 30H 

13 

LD B,A 

14 

• 

ZEN > 



A label must be added to the current line 14 
to loop back. Alter it to read:- 


as it will be required 


14 START:LD A,"Z" 
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Line 7 (labelled TIMES) now call<? =, • 

halts the program and waits for a Key toT e ( °° 9FH > W hi 
Pressed the subroutine returns to our pressed * °nce a key h 

Of the key stored In register A. With the ASCII v al ‘' 

As we oniy require keys , to 9 to h 

register A mu st be checked, and iw A ““*•»»:. , 

was equal to or greater than 31H h T that the key Press 

number , (check with the ASCII code" tLle) ^ l^ 11 Code f °r 

temporarily) 31H from the A register and If t Sl " Ply Subt rac t , 

ASCH code than 31H the carry flag „ iU bess t “ C ° ntal " ad - lowel 

relative jump back to line 7 for * h ' henCe Une 9 is 

kev to ' *° r Processor to wait t a 

k ey to be pressed, if there was such a carry. ° r anot h*r 

Subsequently the program must now check for a hi h 

Lme 10 compares for 3AH wh . , . gher key than q 

equal the colon “ ' h ™ ^ ASCI1 tab ** will be seen ' 

restive lump baL lo lir 7 rr i9he : ^ ^ . 

:: r :i f ^\r *r z: z 

- - -. - we i r b ri„r:a^: s a :- ;: -i 

Assuming that a correct kev 

contains a number between 31H Ind “h” nd re9ist « * 

between 1 and 9, and line 12 does *“ “ e mUst c °"vert this to 

register A leaving it with a value , to 9. “ SUbtracts 30H from 

Line 13 loads register B with the 

be the counter for the amount ofZT ^ A - « B is to 

There is one extra line Ent • S We wil1 Print the alDhah t 

E "ter T23* 'RETURN' and •». Phabet ' 

dna E RETURN' 

TO 

displayed ENTER 


23 

24 

ZEN > 


djnz START 
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^ , 'v 

h 'y 

V( 

\\ 

>.y 

>/ 
t f : 


This command was discussed in the 'w i 

2 and is a „ n <„. „ 0 Special jumps section in chapter 

i anu is a unique Z80 instrurHnn , 

decrements b *nr» ~ . XOn ^ or the B register which 

decrements B and executes a relan»« 

nominate, to carry out the instr ! P ^ t0 wherever yOU 

decreases to zero, similar to p U ° " S in the loop again until B 
. . . nular to a FOR..NEXT loop in Basic In this 

case it jumps back to line 14 whi^h • , . Basic, in tnis 

which is labelled START. 

One will have to sssemhio fu_ 

T , Program before it is capable of being 

run. If errors occur durina accamio 

9 assembly refer back to the specified 
line and check it in this rhanfor m 

p er. To run enter 'GE000H' 'RETURN' 

and for BKPT enter 'RETURN' 


The assembled listing:- 


PAGE 1 


1 


ORG 

0E000H 

z 


LOAD 

' 0E000H 

3 

LOOP: 

EQU 

0A000H 

4 E000 CD4908 


CALL 

0849H 

5 E003 2130E0 


LD 

HL,MESG1 

6 E006 CD7866 


CALL 

6678H 

7 E009 CD9F00 

TIMES: 

CALL 

009FH 

8 E00C FE31 


CP 

31 H 

9 E00E 38F9 


JR 

C,TIMES 

10 E010 FE3A 


CP 

3AH 

11 E012 30F5 


JR 

NC,TIMES 

12 E014 D630 


SUB 

30H 

13 E016 47 


LD 

B, A 

14 E017 3E5A 

START: 

LD 

A, "Z" 

15 E019 CDA200 

NEXT: 

CALL 

00A2H 

16 E01C 3D 


DEC 

A 

17 E01D FE40 


CP 

"A"-1 

18 E01F 20F8 


JR 

NZ,NEXT 

19 E021 3E0D 


LD 

A,0DH 

20 E023 CDA200 


CALL 

00A2H 

21 E026 3E0A 


LD 

A, 0AH 

22 E028 CDA200 


CALL 

00A2H 

23 E02B 10EA 


DJNZ 

START 

24 E02D C3OOA0 


JP 

LOOP 

25 E030 494E5055 

MESG1: 

DB 

"INPUT It 


25 E034 54203174 
25 E038 6F390A0D 

25 E03C 00 

26 • 


;JUMP ON END 
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USER INPUTS .2 


This section deals with user inputs 
against single key inputs, entering a 
printed a number of times. 


of unspecified length, 
string from the keyboard to 


in this example all addresses have been labelled 
writing a longer program, and entering should 
getting it right. Enter 1 K’ and 'RETURN' to 
program followed by 'E' and 'RETURN . 


, as one would wh en 
be good practise at 
kill the existing 


TO 

DISPLAYED ENTER 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 
11 
12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 
23 


ORG 0E000H 
LOAD 0E000H 
LOOP:EQU 0A003H 
;ROM ROUTINES 
PTMESGlEQU 6678H 
PINLIN:EQU 00AEH 
CLS:EQU 0849H 
INPBUFlEQU 0F55EH 
CHGET:EQU 009FH 
CHPUT:EQU 00A2H 
;CONTROL CODES 
BL:EQU 7 
CRlEQU ODH 

NEWLNElEQU OAH 

• 

9 

CALL CLS 
LD HL,MSG1 
CALL PTMESG 
CALL BELL 
CALL PINLIN 
CALL CRLF 
LD HL,MSG2 
CALL BELL 
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24 

CALL PTMESG 

\ 

25 

TIMES:CALL CHGET 

26 

CP 31H 


27 

JR C,TIMES 

A 

28 

CP 3AH 


29 

JR NC,TIMES 

30 

SUB 30H 

V, 

31 

LD B,A 


32 

AGAIN .‘CALL CRLF 


33 

LD HL,INPBUF 


34 

NEXTCH:LD A,(HL) 


35 

CP 0 


36 

JR Z,FINI 


37 

CALL OUTPUT 


38 

INC HL 


39 

JR NEXTCH 


40 

FINI:DJNZ AGAIN 


41 

CALL CRLF 


42 

JP LOOP 


43 

• 

f 


44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 
ZEN 


;OUTPUT ROUTINES 
BELLiLD A,BL 
JR OUTPUT 
CRLF:LD A,NEWLNE 
CALL OUTPUT 
LD A,CR 

OUTPUT:CALL CHPUT 

RET 

• 

;MESSAGES 

MSG1:DB"ENTER A " 

DB M STRING",ODH,OAH,0 

MSG2:DB"INPUT 1to9",ODH,0AH r 0 

END 
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„ raro with a call to the clear ^ 

16 commences the PJ° in the equates, at 0849„. 

routine, *«*» loade d into HL and printed by a ca U ^ 

message to enter a 
66 78H (PTMESG)• 

. h 4 . entered in the output routines i„ ^ 
tine 19 calls BELL which the deslr ed character, i n ^ 

45 where register A is °a to OOT PUT (line 50) where a cay 

case BL (7), and the progra• 3 „ of reg A afterwhich a ret Utr , 

to CHPUT (00A2H) outputs Thls line calls the ROM routi„ e 

is made back to the next line frQm the keyboard until ths 

PINLIN (00AEH) «««* stores the string in the input bu„ er 

•RETURN' key is P r the carriage return and line feed 

(INPBUF) at 0F55EH. Line c A ±s loa ded with the ASCII 

subroutine (line 47) where once a newlNE (OAH), and is 

value of the control ^acter,^ ^ ^ Line 51 returns to the 

outputted by a call t where a is loaded with the Ct 

line after the last cal does not call , 

code (ODH) and this time the program runs i , ^ ^ ^ ^ , 

line 50 to output the character « » ^ call (Une 22) 

will return to the program me is followed by a 

whereupon the second message is loaded into 

call to BELL and the message is printed in 

Lines 25 to 31 get a number from 1 to 9 as the previous progran. 

Line 33 loads the start of the input buffer, where the string is 

stored, into HL and line 34 loads the first character of the strin 
into reg A and it gets printed in line 37 which calls OUTPUT. Whe 
a string is stored in the input buffer the byte after the last byte 
of the string is loaded with a zero, therefore in line 35 we comp 

the contents of reg A for zero and if the test is positive * 

relative jump to FINI (line 40) is carried out in line 36. Line 3 
increments HL to move it up to the next character in the input 
buffer and line 39 jumps back to NEXTCH (line 34) to load the 
character into reg A once again and compare it with zero. 

Line 40 decrements reg B, which was set up as a counter, and loop 
back to line 32 (AGAIN) to print the string once more. Line 41 
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performs another line feed and carriage return before the program 
•jumps back to LOOP (0A003H) the warm start address of ZEN. The main 
difference with the ZEN addresses 0A000 and 0A003 is that on 
completion a jump to OA003 will maintain the condition of the 
re gisters allowing one to enter 'X' and 'RETURN' to examine the user 
registers. Very useful when programs are playing up. 


iphe following assembled listing is reproduced using the 'P* option 
for printer, the main differences between this and the 'V' video 
option is that line numbers are included in the printout and the any 
comment fields are shown in full due to the additional columns being 
available. To run the program enter GE000H and 'RETURN' twice, 
afterwhich the screen will clear and the 'ENTER A STRING' message 
will be printed. After one has entered a string of characters the 
'INPUT 1to9' message will be shown and on entering a value between 1 
and 9 the string will be printed. 



ORG 

0E000H 


LOAD 

0E000H 

LOOP: 

EQU 

0A003H 

;ROM ROUTINES 


PTMESG: 

EQU 

6678H 

PINLIN: 

EQU 

00AEH 

CLS: 

EQU 

0849H 

INPBUF: 

EQU 

0F55EH 

CHGET: 

EQU 

009FH 

CHPUT: 

EQU 

00A2H 

;CONTROL 

CODES 


BL: 

EQU 

7 

CR: 

EQU 

ODH 

NEWLNE: 

EQU 

OAH 

! 

CALL 

CLS 


LD 

HL,MSG1 


CALL 

PTMESG 


CALL 

BELL 


CALL 

PINLIN 


CALL 

CRLF 


LD 

HL,MSG2 


CALL 

BELL 


CALL 

PTMESG 

times: 

CALL 

CP 

CHGET 

31 H 


PAGE 1 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 E000 CD4908 

17 E003 2151E0 

18 E006 CD7866 

19 E009 CD42E0 

20 E00C CDAEOO 

21 E00F CD46E0 

22 E012 2162E0 

23 E015 CD42E0 

24 E018 CD7866 

25 E01B CD9F00 

26 E01E FE31 

27 E020 38F9 

28 E022 FE3A 

29 E024 30F5 


jr C,TIMES 
CP 3AH 
jr NC,TIMES 
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30 E026 D630 

31 E028 47 

32 E029 CD46E0 

33 E02C 215EF5 

34 E02F 7E 

35 E030 FE00 

36 E032 2806 

37 E034 CD4DE0 

38 E037 23 

39 E038 18F5 

40 E03A 10ED 

41 E03C CD46E0 

42 E03F C303A0 

43 

44 

45 E042 3E07 

46 E044 1807 

47 E046 3E0A 

48 E048 CD4DE0 

49 E04B 3E0D 

50 E04D CDA200 

51 E050 C9 

52 

53 

54 E051 454E5445 

54 E055 52204120 

55 E059 53545249 
55 E05D 4E470D0A 

55 E061 00 

56 E062 494E5055 
56 E066 54203174 

56 E06A 6F390D0A 

56 E06E 00 

57 



SUB 

30H 


LD 

B, A 

AGAIN: 

CALL 

CRLF 


LD 

HL,INPBUF 

NEXTCH: 

LD 

A,(HL) 


CP 

0 


JR 

Z,FINI 


CALL 

OUTPUT 


INC 

HL 


JR 

NEXTCH 

FINI: 

DJNZ 

AGAIN 


CALL 

CRLF 


JP 

LOOP 


;OUTPUT ROUTINES 


BELL: 

LD 

A,BL 


JR 

OUTPUT 

CRLF: 

LD 

A,NEWLNE 


CALL 

OUTPUT 


LD 

A, CR 

OUTPUT: 

CALL 

CHPUT 

• 

RET 


9 

; MESSAGES 

MSG1 : 

DB 

"ENTER A " 


DB 

"STRING",0DH,0AH,0 

MSG2: 

DB 

"INPUT 1to9",0DH,0AH,0 


END 
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C AVING programs 

Although one probably won't need to save this program on tape it 
is a good idea to use this small program to practise getting it 
right, it is not so straightforward as saving a basic program, so 
making mistakes now will be less costly than when your own machine 
code masterpiece is at stake. 

ZEN has 2 methods of saving machine code programs. The first is to 
save the source file as an ASCII text file. ASCII text files (or 
programs) are made up of the pure text which has been entered from 
the keyboard. One will require this option for saving unfinished 
programs, which obviously cannot be assembled in that state, for 
future loading using ZEN which would be achieved by entering 'R' and 
'RETURN* after the ZEN prompt. 

Entering 'H' and 'RETURN' will now display the start and end of the 
source file and the top of memory. At this stage the last program 
should display, if one hasn't added extra spaces or comments:- 

C000 C2A7 F37F 

If one enters 'QC000H' and 'RETURN' the text entered will be shown 
in memory byte by byte. To save an ASCII text file using ZEN enter 
'W' and 'RETURN' and one will be prompted for a file name, 
afterwhich it will be saved on tape as normal. Afterwhich one 
should verify the saved file. 


The second method is for saving the object file as a binary file. 
Binary files are the assembled program, and what gets saved is the 
pure machine code file, without comments, ready to run. In the last 
program it could be saved and then run directly from the loading, 
without ZEN being present, by simply BLOAD although one would need 
to alter line 42 from JP LOOP to RET as we would not require a jump 
to A003 if ZEN was not loaded. 
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To test that one is conversant in saving a bin 

the following:- n ^ry fii e 

Alter what should be line 42 to read:- 
42 RET 




™ ^ as>!semDAe the program once again k 
- ntry is correct that win take no time at U the ah 

assemble to the screen b y entering 'V and ^ 

the end address of the file. After altering Un Mu S T 

will be 2 bytes shorter making the end of program E0 6 C ^ ^ 

Place a fresh tape in the cassette and enter „■ 

write binary. One will be prompted for the START a a? Ch f„ 

E000H’ and 'RETURN' it • . ad dress So 1 

.. ' lfc 18 ^portant to enter e *t 6l 

otherwise ZEN will believe it is a decimal number which /"**“ > 

1 As not > 

Next prompt is for the STOP address so Pn f . 

Which is the last byte of the program. and RE Tu Bs . 

The next prompt is for the EXEC address which is where th 

should run from. In this case we want to run from the s Pr09rM 

-it loaded from so enter once again 'EDOOR-, *RETuRw^ me address 

added because a program does not always execut^ f ' • * 

address in memory. It may be that a program is written Id'th T 

some screen graphics titles added to the end of it but t l 

t^that °of “the ^loading -11 be LLI 

Ih iS ,a S , f ° ll0 " ed by the WAD P™»Pt £°r the address at which it 
should load into, and again enter 'EOOOH'. 

The final prompt is for a file name, we could simply call this 

that remains is to set the cassette to record mode* 


Once the file has been saved switch off the computer, wait a te* 
seconds, (never switch off and on quickly) and turn it back on and 
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load the test program by entering:- 
bload"test",r 



So % 
f fi< C 


not 




Progra; 

iddres: 


which after 
correctly, 
display the 


a few seconds, will a 
and when finished will 
'Ok' message. 


utomatically run if you saved it 
jump into the Basic mainloop and 


Mease understand that this was an exercise to correctly save and 
subsequently load and run machine code programs, which normally 
should be far more exciting than the Test program, and it is far 
less costly in programming hours to get it right at this stage than 
get it wrong and lose many hours work. 


CRASHES 


When testing programs in ZEN it is quite feasible that there may 
be something wrong with your program and it may crash, fall out of 
Zen's control, into Basic or even re-initialise and display the 
switch-on MSX screen message. One should be able to jump back into 
ZEN by entering 
DEF USR=&HA000 
A=USR(0) 


:xec « 

star: 
en te 
:h 02:* 
ferec* 

;l) 


and hopefully ZEN, and your program, will still be in memory and 
debugging can continue. This may also happen when accessing Basic 
routines from a machine code program for if an error occurs the 
error trap routine within Basic could pick up the error, display an 
error message, and dump you into Basic s mainloop with the Ok 
message. To simplify the restoration one could enter the above 2 
lines with line numbers, making it a 2 line Basic program, and if 
the crash was not too severe entering the 'F5' key for Run should 
restore control to ZENs mainloop. 
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MSX B° 


otines 


hich are provided 
ore routines «hrch 

frates m ° re 

,. r demonsti them* 

-a - - access 


t0 produce notes i„ % 

. „ program uses keyboard r gives it SO me appe 

following P roy « octaves , w ' 

, fo b In any of the one method of access!,. 

ranqe nurpose is to demonstr follows 

but its earn P utp °“ . u pro duce sounds are 
, The keys which win f 
tables * R T U I 0 

D F G H J K L 


ire used for notes C to B whilst the keys on the top 
The lower row are used pressing the '£' key exits the 

row signify the sharp keys <C* etc). 

program. The Octave is set to 4 when the program runs but can be 
altered by entering keys 1 to 8 while it is running.. 

The current note and octave are displayed on the screen. The 

program uses the Basic PLAY routine at 73E5H, therefore the string 

to be played must look as it would in a Basic program line with 

quotes (") surrounding it and, like the previously used print 

Strings, must terminate with a zero value byte otherwise an error 

-•11 - . . 


will occur and the program will drop into 
statement. 


Basic and display an error 


One should new be familiar with ent. • 

assembled listing ls shoun , however * erlng P^grams so only the 

are uti lised are descrih^H e various ROM routines which 

described after the listing. 
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1 


ORG 

2 


LOAD 

3 

QUIT: 

EQU 

4 

CHGET: 

EQU 

5 

CLS: 

EQU 

6 

POSIT: 

EQU 

; 7 

PTMESG: 

EQU 

8 

CLIKSW: 

EQU 

9 

CHPUT: 

EQU 

10 

ERAFNK: 

EQU 

11 

CHSNS: 

EQU 

12 

• 

f 


13 EOOO CDCCOO 

START: 

CALL 

14 E003 AF 


XOR 

15 E004 32DBF3 


LD 

16 E007 CDC300 


CALL 

17 EOOA 2608 


LD 

18 EOOC 2E02 


LD 

19 E00E CDC600 


CALL 

20 E011 21 CCEO 


LD 

21 E014 CD7866 


CALL 

22 E01 7 260C 


LD 

23 E019 2E0A 


LD 

24 E01B CDC600 


CALL 

25 E01E 21E0E0 


LD 

26 E021 CD7866 


CALL 

27 E024 260E 


LD 

28 E026 2E0C 


LD 

29 E028 CDC600 


CALL 

30 E02B 21E9E0 


LD 

31 E02E CD7866 


CALL 

32 E031 C34CE0 


JP 

33 E034 CD9C00 

INPUT: 

CALL 

34 E037 28FB 


JR 

35 E039 CD9F00 


CALL 

36 E03C FE23 


CP 

37 E03E CA03A0 


JP 


^ ^. r yr ~i ,y > . 


OEOOOH 


OEOOOH 


0A003H 

;ZEN MAINLOOP 

009FH 

;WAIT FOR KEY 

OOC3H 

;CLEAR SCREEN 

00C6H 

;CURSOR SET UP 

6678H 

;PRINT MESSAGE 

0F3DBH 

;KEY CLICK SW 

00A2H 

;OUTPUT CHARACT. 

OOCCH 

;ERASE FUNC KEY 

009CH 

;KEY SCAN 

ERAFNK 

;FUNC KEYS OFF 

A 

;ZERO A 

(CLIKSW),A 

;TURN OFF CLICK 

CLS 

;CLEAR SCREEN 

H, 8 

;SET CURSOR COLUMN 

L, 2 

;SET CURSOR LINE 

POSIT 

;POSITION CURSOR 

HL / MESG1 


PTMESG 


H,12 


L, 10 


POSIT 


HL,MESG2 


PTMESG 


H, 1 4 


L, 1 2 


POSIT 


HL,MESG3 


PTMESG 


PTOCT 

;PRINT OCTAVE VALUE 

CHSNS 

;IS KEY DOWN 

Z,INPUT 

;NO LOOP BACK 

CHGET 

•GET KEY IN REG A 


;IS IT £ KEY 

Z f QUIT 

;YES FINISH 
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38 E041 

FE31 


CP 

31 H 

39 

' E043 

38EF 


JR 

C,INPUT 

40 

E045 

FE39 


CP 

39H 

41 

E047 

3012 


JR 

NC,SAMOCT 

42 

E049 

3295E0 


LD 

(OCTVE+1),A 

43 

E04C 

2615 

PTOCT: 

LD 

H,21 

44 

E04E 

2E0A 


LD 

L, 1 0 

45 

E050 

CDC600 


CALL 

POSIT 

46 

E053 

3A95E0 


LD 

A f (OCTVE+1) 

47 

E056 

CDA200 


CALL 

CHPUT 

48 

E059 

1 8D9 


JR 

INPUT 

49 

E05B 

CD9000 

SAMOCT: 

CALL 

0090H 

50 

E05E 

47 


LD 

B, A 

51 

E05F 

21A7E0 


LD 

HL,TABLE 

52 

E062 

7E 

COMPR: 

LD 

A, (HL) 

53 

E063 

FEOF 


CP 

OFH 

54 

E065 

28CD 


JR 

Z, INPUT 

55 

E067 

23 


INC 

HL 

56 

E068 

B8 


CP 

B 

57 

E06 9 

2804 


JR 

Z,FOUND 

58 

E06B 

23 


INC 

HL 

59 

E06C 

23 


INC 

HL 

60 

E06D 

18F3 


JR 

COMPR 

61 



• 

i 



62 

E06F 

7E 

FOUND: 

LD 

A,(HL) 

63 

E070 

32A3E0 


LD 

(NOTE),A 

64 

E073 

23 


INC 

HL 

65 

E074 

7E 


LD 

A,(HL) 

66 

E075 

32A4E0 


LD 

(NOTE+1),A 

67 

E078 

2193E0 


LD 

HL,STRING 

68 

E07B 

CDE573 


CALL 

73E5H 

69 

E07E 

2615 


LD 

H, 21 

70 

E080 

2E0C 


LD 

L, 1 2 

71 

E082 

CDC600 


CALL 

POSIT 

72 

E085 

3AA3E0 


LD 

A,(NOTE) 

73 

E088 

CDA200 


CALL 

CHPUT 

74 

E08B 

3AA4E0 


LD 

A,(NOTE+1) 


;TEST FOR 1 
;IF LESS GET NEXT 
;TEST FOR 9 
?STILL SAME OCTAVE 
?DISPLAY OCTAVE 
;POSITION CURSOR 
;TO PRINT OCTAVE No 

;NEW OCTAVE 
;PRINT IT 
,*GET NEXT KEY 
;NO QUEUES 
JSAVE KEY IN B 

/TABLE IN A 
?END OF TABLE? 

;YES WRONG KEY 

;COMPARE KEY/TABLE 
;GO PLAY 

/NOT FOUND. BUMP OVER 
;NOTE STRING AND 
; TEST NEXT IN TABLE 

;NOTE TO PLAY 


; SECOND PART OF NOTE 

;HL=PLAY STRING 
JBASIC PLAY ROUTINE 
;POSITION CURSOR TO 
;RIGHT OF NOTE:- 

; PRINT CURRENT 
,‘NOTE, AND 
JPRINT + CHARACTER 
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% 
t)> H K 


r 0h ^ 


S \ 


75 E08E CDA200 


vV\ 

,\\\ 7« E09 ' 1eA1 

p 0 „ W 77 


E H „ 

^ 

, ,NE *n 

-V 


k 


STRING: 
OCTVE: 
TEMPO: 
DURAT: 
ENVPAT: 


NOTE: 


B 


j ARe 


'ft W 77 

^ 5 . \ 78 E093 22 

°V 7 9 E094 4F34 

\g0 E096 543630 
gl E099 4C38 

82 E09B 5330 

83 E09D 4D313030 ENVPER: 

83 E0A1 3030 

84 

85 E0A5 22 

86 E0A6 00 

87 

88 E0A7 444320 

89 EOAA 524323 

90 EOAD 464420 

91 EOBO 544423 

92 E0B3 474520 

93 E0B6 484620 

94 E0B9 554623 

95 EOBC 4A4720 




is 

’ 0p ^ 

^ to 


TABLE: 


KEy /% ; 


My 

found, 
string a® 


next in TiE 96 eobf 494723 

97 E0C2 4B4120 
rO PLAY 98 E0C5 4F4123 
99 E0C8 4C4220 

100 EOCB OF 

101 


PART Of 


102 EOCC 43555252 MESG1: 


102 EODO 454E5420 
* ST0 ^ 102 E0D4 4E4F5445 
’I/A* ^ s 102 E0D8 20 
,N <#$* 103 E0D9 53544154 

p. 103 EODD 555300 

104 EOEO 4F435441 MESG2: 



to 


104 E0E4 56453A2D 
104 E0E8 00 


CALL 

CHPUT 

;OR SPACE 

JR 

INPUT 

;GET NEXT KEY 

DB 

22H 

;START WITH QUOTES 

DB 

"04" 

;OCTAVE 4 

DB 

"T60" 

;TEMPO 60 

DB 

"L8" 

;DURATION 8 

DB 

"SO" 

;ENV WAVEFORM SO 

DB 

"Ml 0000" 

;PERIOD Ml 0000 

DS 

2 

;NOTE STORAGE 

DB 

22H 

;PLAY END QUOTES 

DB 

0 

;END STRING WITH 0 

DB 

"D'V'C " 


DB 

"r" , "c+" 


DB 

"F","D " 


DB 

"T","D+" 


DB 

• l G M llg II 


DB 

lipid lip II 


DB 

"U" ,"F +" 


DB 

"J" ,"G " 


DB 

"I", "G+" 


DB 

"K","A " 


DB 

"0" , "A+" 


DB 

"L","B " 


DB 

OFH 

; END OF TABLE MARKER 


DB "CURRENT NOTE 


DB "STATUS",0 

DB "OCTAVE:-",0 


89 


Scanned by CamScanner 




105 E0E9 4E4F5445 MESG3: DB "NOTE:-",0 

105 EOED 3A2D00 

106 END 


Where practical the names, or labels, assigned to the ROM rou£ifi 6s 
are as used in the MSX specification and should be compatible wit}, 
other publications on MSX. They have a maximum length of 6 
characters and are usually an abbreviation of the function - CHget 
is assigned to the routine which gets a character from the keyboard 
Character GET . 

Analysis 

Line 13-CALL ERAFNK (00CCH) turns off the function key display. The 
sister routine is CALL DSPFNK (00CFH) which turns it back on. 

Line 15-CLIKSW (F3DBH) is the switch for the key press click. Here 
we zeroed A with XOR A and loaded zero into F3DB which turns it off, 
any other value switches it back on. 

Line 16-CALL CLS (00C3H) clears the screen but only if register A 
has been cleared by XOR A. 00C3H contains a jump to the actual CLS 
routine at 0848H, if you wish to clear the screen but aren't sure of 

the contents of A, a CALL 0849H will achieve the same goal by 

skipping the test on the flag. Used in the previous chapter. 

Line 19-CALL POSIT (00C6H) positions the cursor depending on the 
value of HL. In lines 17/18 the column was entered into H and the 

line into L. 

Line 21-CALL PTMESG (6678H) as used previously, prints a message 
with the start address in HL and must terminate with a zero. MESGl 
is shown in line 102. 

Lines 22-31 The same as above. To aid readability H and L are loaded 
on separate lines and decimal values have been used, not hex. 


90 
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^ ne s 27/28 could have been entered using only one line by 
converting the column and line values to hex (14 and 12 become OE 
a nd OC) so entering:- LD HL f OEOCH would make the program shorter. 

. e 33 -CALL CHSNS (009CH) checks the keyboard buffer, where a 

pressed key is stored, and returns with Z flag reset if there 

It does not return with the character. If there was no key line 

a relative jump back to line 33 to do it again. The program wi 
is o 

not P ass these 2 lines until a key is entered. 

Line 35-CALL CHGET (009FH) waits until a key is entered and retur ^ d 
wit h the ASCII value in register A. In fact we could have dlSpe ” iso 
With lines 33/34 as this routine waits i°r a Key but 4^3^ 
displays the cursor if it needs to do any waiting, a means 

spoilt the display, therefore using the CHSNS routin 
that the program does not reach here until a thereby 

and this routine picks up the key and does not need 

the cursor is not displayed. 

rhecks if it was the '£' key and if so line 37 quits 
Une 36 - Che s line jumps hack to ZEN but if one saved this as a 
me UTran it Without ZEN this instruction would he altered 

to RET z. 

nf kevs 1 to 8 to change the octave. 
Lines 38/41- check for input is higher than an 

Similar to the last chapter^cept^hat ^ ^ ^ check on a 

8 the program jumps to 
note to be played. 

, f the key was between 1 and 8 and loads the 

““ (2 V S ocS - - “ St ° red - 

value into OCTv 

, cnr nex t to the octave message on screen 

Lines 43/45 position the cu 
with a call to POSIT. 

/nna7H> outputs the character in the A register, 

Line 47 -CALL cHPUT ^ afc the cu rrent cursor position already 

which was loaded 
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specified in lines 43/45 and line 48 jumps back to INPUT for 


next key. 


One could alter line 47 from CALL CHPUT to RST 18H 


outputs register A to the current device, be it printer, screen 


whatever. 


Line 49-CALL 0090H (GICINI) initialises the Programmable Sou r 


Generator (PSG) and has been used to eliminate 


queue of not 


being stored and so not continuing to play for minutes after the )^ e 
was released. Try deleting this line for different results. 

Line 51-LD HL,TABLE loads HL with the start address of the table 0{ 
notes in line 88. The key entered has been stored in register b j n 
line 50 and the first entry of the table is loaded into A in li ne 
52. Line 53 compares A with OFH as this defines the end of the 
table and if the key was not found it is assumed that an alien key, 
such as Z or X, was pressed and therefore nothing should be played 
and a jump back to INPUT is made for another key. 

Line 55 increments HL, moves it up a byte, and line 56 compares the 
key pressed (in B) with the table (in A) and if the two match a 
relative jump is made to FOUND to play the note (first time round it 
would be comparing with the first key in the table, key D). If the 
key did not match then HL must be moved up past the following bytes 
and must now point to the key 'R 1 in line 89, remembering it has 
been incremented once, so lines 58/59 incement HL twice more and 
line 60 jumps back to compare the next entry in the table. Tins 
comparing continues until HL is looking at the first byte in line 
100 (OFH) as this is where lines 53/54 checked for the end of the 
table, which OFH is, and aborted back to INPUT. 

Line 62-FOUND is reached when the key pressed matched a key in the 
table and a note must be played. Remember that HL is pointing to 
table and has previously (line 55) been incremented. Assume the ^ 
key was entered and HL will now be pointing to the byte after 
line 88 of the table. This is the letter of the note to e 
and therefore gets loaded into register A (line 62). Line 
this note into position in the string, labelled NOTE in line 
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V , MF,£•*- *> V- • ' *’ ' • • N*?*"; 

• v ;Sl#’c w • 



en 

a 


I” £3Ct 2 tyte = have been 

entering it as . Ds 2 , n r «erve d (oc 

the second byte i s us ; The ‘irst ls the *“ " ote ln Une 84 by 
t (ie table (l lne 08 . to store the ■*. . the note " hUe 

\tered after ‘S'* f ° U °-d * “ 9n \, The "«e in 

although no action u tahen' * re IT" “ 

previously stored note alon,^ ^ -bsegnently over- H l 

T0 load rn the second part o^ th *' •**> i£ contained it. 

register A is either loaded with " 0te Une 64 t"creeents HL, 
stores it into NOTE +1 Which is th SPaCe ° r sign a "d line 66 

the second byte of the storage. 

Line 68-CALL _. 

the 

achieves 


calls the Basi 

start of the string to be ol l routlne f °r PLAY which requires 
eves. aye to be in H L, which line 67 

tines 69/71- position the cursor adjacent to the NOTE- —— 
screen in order to display the note being played. " 

LlH6S 72/75 load til© nnf p e n L A » j , 

cne n ° te lnto A and print it with CALL CHPUT as 

used for the octave print in lines 43/47. As the note is always 2 

characters long register A is subsequently loaded with the second 

byte of the note storage and similarly gets displayed in line 75 . 

The cursor does not require positioning for the second byte as it 

will have been automatically moved along one screen position after 

the previous CHPUT in line 73. This is then followed by jp INPUT to 

get the next key. 


Line 78- STRING is where the whole of the PLAY string is stored. 
Line 78 contains the ASCII value for "" which must open and close a 
Play string. As we are accessing a Basic function it must appear 
syntactically correct else an error will be instituted and our 
machine code program will crash back into Basic, not a pleasant 
thought. Line 79 stores the octave and commences with the character 
0, not zero, and is followed by the starting value 4. This second 
byte obviously gets altered if one presses keys 1 to 8 whilst the 
Program is running and so changes the octave. 






An/83 set the remainder of the string for Tempo , T60| 
Line " . En velope waveform (SO zero this time, not 0) ^ 

Envelope Period (M10000,. These values remain constant, the onl) 
alterations via the keyboard are to the note and octave, al thoiJ% 
one can change them and re-assemhle the program whrch tahes seco„ ds , 
for different results. One could also alter the program to acce pt 
the cursor Keys for instance to alter tempo, duratron or waveform. 

Line 84- contains the note storage which is blank "hen the pro gta , 
first runs. Line 85 is the ASCII value for the closing sign ani 
line 86 contains a byte with a zero value which must be entered t . 
signify the end of a string, just like the print strings. 

Lines 88/100 contain the table of keys followed by there respective 
notes and the line 100 contains the end of table marker OPH. 


Lines 102/1 05- are the print strings which one should be familiar 
with by now, taking note of the trailing zero byte after each. 


To save as a binary file use the same procedure as in the last 
chapter. Alter line 37 to RET Z and note the last byte of the 
program when re-assembling to video and enter it when prompted as 
the STOP address. 

This program was written to run on screen 0 but is quite possible to 
run on screen 1 except the display will be slightly moved to the 
right, it will not upset the POSIT routine which positions the 
cursor. One could enter a line at the start of the code to 
initialise the screen:- 

CALL 006FH 

(INIT32) will initialise to screen 1. 

CALL 006CH 

(INITXT) initialises screen 0. 
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94 


The MSX allocates memory locations FD9A to FFC9 to what is known 
a Hook area. There are 112 hooks each containing 5 bytes. 

se veral routines within ROM make a call to these hooks to find if 
, oV contain additional instructions for tasks that should be 
^formed. Normally they all contain the value C9 hex, which is the 
c0 de f° r RETurn instruction. Quite simply the routine in ROM 

calls the hook, finds it must return and do nothing, and carries on 
from where it left off. As sophisticated software becomes available 
for MSX these hooks will be used to hook up to disc drives and other 
peripheral devices in order to expand the system without the need to 
change the ROM. In order to write to a hook one must obviously know 
from which ROM routine it is called, so indiscriminant use could 
cause all sorts of problems, the rule should be, if you aren't sure 
leave it. 

The following program writes instructions into one such hook, at 
FD9F, labelled HTIMI. It is called from the timer interrupt handler 
routine, which means it is accessed 50 times a second whatever task 
the MSX is performing, excluding reading or writing to tape. This 
obviously lends itself to be used as a built in timer as one knows 
how many times a second it will be encountered. 

It has been used in the next program to slow down the movement of 
sprites, as without the delay they would move too quickly for the 
eye to see. Yes we could have written a machine code routine to 
create a delay, but that would not have demonstrated the use of a 
hook. 
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sor (VDP) used in the MSX is extren,^ 
The Video Display Process complex to the average Us ^ 

powerful and at first may a ^ ^ a time . your awareness of ^ 
but then again so did ^ ^ the amount o£ information g iv6( 

capabilities wrll pr particular machine. In order to 9e( 

in the manual supp r ^ msx Qne should a t least be convert^ 
the best from e iable commands and how to access th e 

with the Basl = ™ P Sy ® h . S( unfor tunately, cannot be described in 0 » s 

chapter "nr is 'beyond the scope of this introduction to machi, 
code Fora fuller knowledge of its workings one would be w ell 
advised to obtain a book specifically written on the VDP of the MSX, 
one such book is titled 'Behind the Screens of the MSX by Mike 
and should answer most if not a 11 nf ones Questions. 


Shaw 


The main task of this next program is to set up 2 sprite patterns 
and move one across the screen until it collides with the other 
whereupon it will move up to the top of the screen. This program is 
only a demonstration of how to get sprites moving and detecting 
collisions, but with the machine coding practise you should have 
now, it could prove a good core program to fire-up the grey matter 
in order to get a complete display moving. One could try testing 
for the cursor keys being pressed and move the sprites accordingly, 
altering the shape and colours of the sprites etc* 

The explanations follow the assembled listing. 
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1 


1 

3 

4 

5 

6 

7 

8 
9 


10 

11 

12 

13 

14 

15 

16 EOOO 219EE0 

17 E003 1 19FFD 

18 E006 010300 

19 E009 EDBO 

20 

21 EOOB CDCCOO 

22 EOOE CD6F00 

23 

24 

25 

26 E011 AF 

27 E01 2 47 

28 E01 3 0E06 

29 E01 5 CD4700 

30 

31 

32 

33 E018 3AE0F3 

34 E01B F601 

35 E01D 47 

36 E01E OEOI 

3 ? E020 CD4700 



ORG 

0E000H 


LOAD 

0E000H 

CHSNS: 

EQU 

009CH 

HTIMI: 

EQU 

0FD9FH 

ERAFNK: 

EQU 

OOCCH 

WRTVDP: 

EQU 

0047H 

RDVRM: 

EQU 

004AH 

WRTVRM: 

EQU 

004DH 

INIT32: 

EQU 

006FH 

RG1SAV: 

EQU 

0F3E0H 

STATFL: 

EQU 

0F3E7H 

ATTR1: 

EQU 

1 BOOH 

ATTR2: 

• 

EQU 

1B04H 

1 

;WRITE 

CODE TO HOOK (HTIMI) 


LD 

HL,CODE 


LD 

DE,HTIMI 


LD 

BC, 3 


LDIR 


} 

CALL 

ERAFNK 


CALL 

INIT32 

7 

;ALTER 

SPRITE PATTERN 

;GENERATOR BASE 

ADDRESS TO 0000 


XOR 

A 


LD 

B, A 


LD 

C,6 


CALL WRTVDP 

• 

t 

;ALTER 

BIT 0 OF 

VDP REG 1 

; TO 1 . 

TO INCREASE MAGNITUDE 


LD 

A,(RG1SAV) 


OR 

1 


LD 

B, A 


LD 

c,i 


CALL WRTVDP 


;TURN OFF FUNC KEYS 
; SCREEN 1 
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38 

39 

40 E023 3E8C 

41 E025 21001B 

42 E028 CD4D00 

43 E02B 3EC8 

44 E02D 21011B 

45 E030 CD4D00 

46 E033 3E41 

47 E035 21021B 

48 E038 CD4D00 

49 E03B 3E01 

50 E03D 21031B 

51 E040 CD4DOO 

52 

53 

54 E043 3E8C 

55 E045 21041B 

56 E048 CD4D00 

57 E04B 3E1E 

58 E04D 21051B 

59 E050 CD4D00 

60 E053 3E42 

61 E055 21061B 

62 E058 CD4D00 

63 E05B 3E0F 

64 E05D 21071B 

65 E060 CD4D00 

66 

67 E063 AF 

68 E064 3298E0 

69 

70 E067 CD9COO 

71 E06A 2024 

72 E06C 3A98E0 

73 E06F FE01 

74 E071 38F4 

98 


9 

?SET UP SPRITE 1 



LD 

A, 140 


LD 

hl,attri 


CALL 

WRTVRM 


LD 

A, 200 


LD 

HL f ATTR1+1 


CALL 

WRTVRM 


LD 

A,65 


LD 

HL f ATTR1+2 


CALL 

WRTVRM 


LD 

A,1 


LD 

HL,ATTR1+3 

• 

CALL 

WRTVRM 

9 

;SET UP SPRITE 2 



LD 

A, 1 40 


LD 

HL,ATTR2 


CALL 

WRTVRM 


LD 

A,30 


LD 

HL,ATTR2+1 


CALL 

WRTVRM 


LD 

A,66 


LD 

HL,ATTR2+2 


CALL 

WRTVRM 


LD 

A,15 


LD 

HL,ATTR2+3 


CALL 

WRTVRM 

9 

XOR 

A 

;DELAY 

LD (COUNT),A 

COUNTER CHECK 

CKMOVE: 

CALL 

CHSNS 


JR 

nz,quit 


LD 

CP 

A,(COUNT) 

1 


JR 

C,CKMOVE 


;VERTICAL POS 


i HORIZ POS 


; CHARACTER 65=a 


;COLOUR BLACK 


?VERTICAL POS 


;HORIZ POS 


;CHARACTER 66 =B 


;COLOUR WHITE 


JZERO COUNTER 


; IF LESS DONT MOVE 
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X 


1b 

: 70 


7? E073 21051B 
' 8 £076 CD4A00 
79 E079 3C 
,0 E07A CD4D00 
“ E07D AF 
g 2 E07E 3298E0 


83 


34 £081 3AE7F3 
85 E084 CB6F 
g 6 E086 28DF 
87 


;MOVE SPRITE 2 

LD HL,ATTR2+1 
CALL RDVRM 
INC A 
CALL WRTVRM 
XOR A 

LD (COUNT),A 

;CHECK FOR COLLISION 

LD A,(STATFL) 
BIT 5,A 
JR Z,CKMOVE 



88 


;COLLISION 

OCCURED 


89 E088 

21 041B 


LD 

HL,ATTR2 


90 E08B 

3E28 


LD 

A,40 

' 

91 E08D 

CD4D00 


CALL 

WRTVRM 

• 

92 


• 

9 




93 


;PROG END, 

SO REPLACE RET 


94 


;INTO HOOK 

(HTIMI) 

f 

95 E090 

3EC9 

QUIT: 

LD 

A,0C9H 

i 

: 

96 E092 

329FFD 


LD 

(HTIMI),A 

► 

i 

97 E095 

C303A0 


JP 

0A003H 


98 


# 

9 




99 E098 

00 

COUNT: 

DB 

0 

| 

100 


• 

9 




101 


; INCREMENT 

COUNT 

50 TIMES A SEC 

J 

102 E099 

2198E0 

INCCNT: 

LD 

HL,COUNT 


103 E09C 

34 


INC 

(HL) 

j 

104 E09D 

C9 


RET 


1 

105 


• 

9 



■ 

106 E09E 

C399E0 

CODE: 

JP 

INCCNT 

> 

j; 

107 


• 

9 



) 

108 



END 




;VERT POS 
;PUT INTO A 
;MOVE 1 PIXEL RGHT 
;NEW POS OF SPRT 2 


;ZERO COUNTER 


;TEST COLLISION BIT 
jIF ZERO KEEP MOVING 


;HORIZ POS 
;MOVE IT UP 
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, , ,, OT de into the hook labelled HTIMI at FD9P. % 

Lines ,6/ ' 9 ha5 bee „ used which, as you should know by 

LDIR instruction ess pointed to by HL into that pointed to by 

loads code from t ^ ig held in B C, in this case 3 by Usj 

DE . The amount which te ll the hook to jump to Dree, 

which are shown in e£fect of s i owin 

which increments the counter. This na 

movement and can be speeded up or slowed as will be 


Line 2. is the erase function key routine and this is followed 
INIT32 which switches the display to screen 1, as you cannot hav, 

sprites on screen 0. 


by 


Lines 26/29 Write to the VDP register whose number (0 to 7) must b e 
in register C and the data to be loaded into the VDP held i n 
register B. Here we are loading VDP register 6(C) with 0(B). This 
in effect is altering the base address of sprite pattern table to 
that of the character generator base address. So we now have the 
full ASCII character set stored as sprites. 


Line 33 Loads the value of RG1SAV (F3E0) which stores the current 
value of register 1 of the VDP. The only bit of VDP 1 we are 
interested in is bit 0 which controls the magnification for sprites. 
Zero is the normal size whilst altering it to 1 magnifies the 
sprites, so in line 34 we OR 1 which will not effect the remainder 
of the bits but will turn bit 0 to a 1 , putting it in magnify mode. 
And once again we must load the contents of A into register B, 

select the VDP register in C and call WRTVDP, which will write to 
the VDP register 1. 


Now if that appeared slightly beyond you don't panic, as practise 

makes perfect, just enter the code and alter it later, it can only 
get easier and you will pick it up. 


lines 40/51 set up sprite 1. The sprite attribute table in screen 
commences at address 1B00H and contains 4 bytes for each sprite 
the attributes for sprite 2 will commence at 1B04H. Thes 
ere Riven equates in lines 12/13, ATTR1 and ATTR2. The first byt 
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h oXds the vertical pixel position of the 

re gister A with 140. The screen iL and line 40 loads 

(bottom). Line 41 loads HL with th 1X6lS ^ fr ° m ° (top) to 191 

line 42 loads register A into VRAM at lonn^ 688 ° f ATTR1 (1B00H) and 

VRAM at 1 BOOH by CALL WRTVRM. 


The process continues with loadina f ha u 

register A and storing it i n the second byt 1120 ^ 1 P ° Sltl ° n 
sprite 1 at 1B01H by loading HL with ATTR1 +1 . ° ^ attribute 


into 

for 


NOTE Line 47 could be entered as tnp ht ^ w , u 

as INC HL as when the program 

returns from the WRTVRM routine register HL is not changed in any 

way, therefore it still points to the previous location, and one 

could simply increment it. But it was shown in this form for 

clarity and not program elegance. 


The third byte of the attribute holds the sprite character number. 
But we have not defined our own sprite we have shifted the sprite 
pattern table so it is looking at the ASCII characters, purely for 
convenience. Therefore the ASCII for the letter A is 65 decimal, 
and line 46 loads register A with 65 as the letter A is to be our 
sprite 1 . This is then loaded into the third byte in the 
attributes, ATTR1+2. Note that the although the decimal value was 
used for clarity, the assembler converted it to hex, as one will see 

in the left column. 


Lastly the colour must be defined and loaded into the fourth 
attribute byte ATTR1 +3, and line 49 defines the colour number; 
which is black and this concludes the set up for sprite , ha 

its co-ordinates, character and colour stored in 1B00 

The procedure is "which was "labelled as 

information must be s position is the same as sprite 1, 

ATTR2 in line 13. The ve horizontal (3 0) in line 57, the 

the only differences ei B (AS ciI 66 decimal) and the 

character which this time is the letter 

colour which is 15 for white. 
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• e running these co-ordinates can be altered f 0 
~ ■—« to assemble each tlme ' 

Lines 67/68 zero register A and loads this into COUNT. 

Lines 70/7, is the CHSNS routine which checks for a Key bel^ 
pressed and lumps to the QUIT routine, and has been included so that 
one can stop the program before it finishes to modify it lust * 
case one has slowed it down too much. 

o. 

Line 72 loads the value stored in COUNT into register A and if ffc 
has not reached 1 line 74 jumps back to check it again. This loop 
continues until register A is equal or greater than the value i tt 
line 73. Remember the hook at FD9F is incrementing COUNT 50 times a 
second, therefore CP 1 will only cause the loop to continue for 
1/50th of a second before carrying on with the program and moving 
the sprite by 1 pixel. If line 73 was altered to CP 50 the sprite 
would move by 1 pixel only once a second, very slow. Without the 
delay at hook HTIMI the sprite would move so fast it would simply 
appear at the finishing point. 

Lines 77/82 move sprite 2 and zero the counter for the next delay 
before moving again. The only attribute we are changing is the 
horizontal position, ATTR2+1, therefore this must be loaded into HL 
and a call to read VRAM (RDVRM) will return the value in the A 
register (its current horizontal position). To move the sprite we 
INCrement A and write it back to the VRAM address still pointed to 
by HL by WRTVRM. 

Lines 84/86 check for a collision of the 2 sprites. STATFL (F3E7H) 
holds the status register of the VDP and bit 5 is set to 1 if a 
collision, 2 sprites overlap by at least 1 pixel, has occured. 
Therefore line 85 tests bit 5 of the status flag and line 86 jumps 
if it was zero back to CKMOVE again, if a collision had taken place 
bit 5 would be , therefore the zero flag would not be set and the 
test would fail and the program would fall through to the next line. 
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<?r 






tine 90 is oniy reached after a col Usion anfl 

„ e ar the top of the screen by loading hl by Dt SPrite 2 t0 
A TTR2, leaving the horizontal ATTR2+1 • 6 Vertical attribute 
calling WRTVRM again to re-position it lntaCt ' loading A with 40 and 


Line 95 QUIT is reached after a C olH.4 

pressed while the program was running T* ^ ^ 3 k ° Y ^ 

contents of hook HTIMI with it, * Slmply replaces the 

t • ts ori 9inal byte the code for rpt 

(C 9H) , m case one is going to run an ^h R 

, v, i other program as you will not 

want the hook accessing COUNT 50 times * CQ , Y fc 

rM mes a second, and jumps back to 

ZEN • 


Line 99 is the storage byte for the counter. 

tines 102/104 are accessed only fro* the hook HTIMI, and simply add 
1 to count each time the interrupt occurs. 

Once running experiment with altering the positions of the sprites 
and time delays and try adding a routine for moving each sprite on 
the press of certain keys. 
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t.oader program 


When loading a machine code program one may have seen a diff 
screen message displayed than the usual one or, as is becoming 
popular, the complete display could alter to a graphics title 
the program appears to be still loading* 


er ®nt 


The answer can lie in the fact that two programs have been loaded 
the second automatically. The first short program contains th e 
titles and a jump to the loading routine for the second lar ger 
program. When the first program has loaded it executes immediately 
so printing the titles on screen and enters a loading routine f 0r 
the second. Execution is so fast that the tape stops for a minima 
time and starts again almost without being noticed. Only one 
1 Foundiprogram name 1 message appears on screen whilst the first 
program is loading. 


The loader program begins with the screen title message, in the 
example it will display 'NOW LOADING MAIN PROGRAM', but this can be 
expanded upon as will be explained. It is advised to only add the 
loader jump section after fully debugging and testing the graphics 
titles. Although the ORG is set at 9000H, which is ideal for 
testing, before saving the object file it could be altered to 
another memory location, this also means that the second program 
could be set to the same ORG before saving and the loader program 
will be overwritten and dissappear from memory as the main program 
loads in. If one has recorded an ASCII file of one of the earlier 
programs it will be simple to test this loader. First complete the 
entries on the next page, making sure it runs correctly, then add in 
the loader section carefully and save as a binary file by the 'WB' 
command. Verify the tape and do not rewind as the main program will 
be recorded starting from where the first finished, on the next 
section of the tape. Kill the loader program from memory and load 
in a program from the earlier chapter Assemble and save the second 
program with the 'WB* command onto the tape, and one should possess 
two programs on the tape, the second will automatically load and 
run. 


-\r\ a 
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1 


l 

3 

4 

5 

6 

7 

8 
9 


10 

11 

12 

13 9000 CDCCOO 

14 9003 3E09 

15 9005 32EAF3 

16 9008 32EBF3 

17 900B 3E01 

15 900D 32E9F3 

19 9010 CD6F00 

20 9 0 1 3 2 1 00 1 8 

21 901 6 3ED1 

22 9018 010003 

23 901B CD5600 


INIT32: 
ERAFNK: 
FORCLR: 
BAKCLR: 
BDRCLR: 
CHGCLR: 
T32NAM: 
LDIRVM: 
FILVRM: 


24 901E 212D90 
I 25 9021 1 1 631 9 

26 9024 01 1 A00 

27 9027 CD5C00 

28 902A C300A0 


29 ; 

30 902D 204E6F77 DISPL: 
30 9031 204C6F61 

30 9035 64696E67 

31 9039 204D6169 
31 903D 6E205072 
31 9041 6F677261 

31 9045 6D20 

32 


ORG 

9000H 

LOAD 

9000H 

EQU 

006FH 

EQU 

00CCH 

EQU 

0F3E9H 

EQU 

0F3EAH 

EQU 

0F3EBH 

EQU 

0062H 

EQU 

1800H 

EQU 

005CH 

EQU 

0056H 

CALL 

ERAFNK 

LD 

A,9 

LD 

(BAKCLR),A 

LD 

(BDRCLR) ,A 

LD 

A,1 

LD 

(FORCLR),A 

CALI 

, INIT32 

LD 

HL,T32NAM 

LD 

A, 0D1 H 

LD 

BC,768 

CALL FILVRM 

LD 

HL,DISPL 

LD 

DE,T32NAM+355 

LD 

BC, 26 

CALL LDIRVM 

JP 

0A000H 

DB 

" Now Loading" 

DB 

" Main Program 


END 


! 

f 

r 

► 

\ 


4 ; 

'■ 

< 

V 
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Analysis 

Line 13 which has been used before erases the function keys. 

Lines 14/18 set up the colours. Register A is first loaded with th 
code for the colour light red, and this is loaded into the stora 
bytes for background (BAKCLR) and border (BDRCLR) colours at F 3 Ea 
and F3BE respectively. The character colours (FORCLR) is loaded 
with register A, this time 1 for black, at F3E9. 


Line 19 initialises screen 1 which will clear the screen and 
it to the new colours. 


change 


NOTE If one wished to simply alter the existing colours whilst 
remaining in the same screen mode and maintaining what was 
currently displayed on screen, a call to 0062H (CHGCLR) would 
suffice after setting up the colours. 

Line 20 loads HL with the start of the Name table for screen i 
(1800H), the top left position. 

Line 21 loads register A with the code for the character which will 
cover the screen whilst line 22 loads our byte counter (register BC) 
with the number of positions we will write to. As screen 1 contains 
24 lines of 32 characters BC is loaded with 768 decimal, it could of 
course been converted to hex to read LD BC,300H. 


Line 23 calls a routine (FILVRM) at 0056H which writes the data in 
register A to VRAM, which has its source address in HL and the 
number of bytes in BC, all of which has been done. If one only 
wanted to write to the centre 4 lines of the screen then HL would 
instead have required loading with the start of the name table plus 
the offset. The tenth screen line starts at 288 positions (32x9 as 
first line is 0) higher than the start of the screen, therefore 
progam line 20 could have read;- LD HL,T32NAM+288. But obviously 
the byte counter would require reducing too, for 4 lines of print it 
should be loaded with 128 decimal (32x4). 
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24/26 load the start of our actual screen message ' Now 

Jji ne 

a ding Main Program ' (labelled DISPL) into HL, load the 

r 

^gtination address of its position into DE, and load the length or 
message into BC (26 bytes including the leading and trailing 

tn e 

aces) • As the message should commence 3 positions in from the lerr 
line 12 the actual screen position is calculated thus:- 32x11+3, 
the top line is 0 therefore to calculate the 12th line, the 

lin e width of 32 is multiplied by 11 . 

. 27 calls LDIRVM at 005CH which was used in chapter one to load 

kins ^ 

VRAM directly with the contents of an area of RAM. 

28 jumps back to the ZEN mainloop so the titles can be altered 
and run until it reaches your satisfaction. This jump address will 
le altered when we add the loading section. 

after entering G9000H the display will switch into screen 1 mode 

the screen with the ASCII character of 'Dl ' and t e cen 
and cover the screen first and then make 

use Will print our message. Get it run 9 ering to 

alterations to colour, length of message etc., 

y0Ur h e af er each change in the program otherwise the changes will 

wintered into memory. .ter each 

=:rr;r:r.i; — - - - - 

'RETURN' key on its own. 


The Loader 


TO append the loader routine 
'END' message the current line, ^ 
it should be line 32, and enter 
listed on the following page. 


make 
if one 
E* and 


the line which contains the 
has not altered the program 
.Return 1 and add the lines 
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DISPLAYED 

32 

33 

34 

35 

36 

37 

38 

ZEN 


TO 

ENTER 

LOADER:LD A,OFEH 
LD (0F41CH),A 
LD HL f STRING 
JP 6EC6H 

STRING:DB 22H,"CAS:" 
DB 22H,2CH,"R",0 




i 


Line 28 which is the jump to Zen requires altering to:- 
JR LOADER 

this will then make the program jump to the loader routine after the 
titles have been displayed. Make sure the last line is s * 
and assemble the program to (V)ideo and make a note of t e as y e 
of the program. If one has not altered the program it should be 
905AH but obviously your program could be longer. The final section 
of the program would have assembled like this:- 


32 9047 3EFE LOADER: 

33 9049 321CF4 

34 904C 215290 

35 904F C3C66E 

36 9052 22434153 STRING: 

36 9056 3A 

37 9057 222C5200 

38 


LD A, 0FEH 

LD (0F41CH),A 
LD HL,STRING 
JP 6EC6H 
DB 22H,"CAS:" 

DB 22H,2CH,"R",0 
END 


Quite simply we have loaded the value FE Hex into the contents of | 
F41CH which stops a second 'Found:' message being printed when the 
second program is loading, which would spoil the display. Line 34 
loads HL with the start of a string which are the characters that | 
could normally follow a BLOAD command i.e. "CAS:",R. We then jump 
to the BLOAD routine in ROM at 6EC6H. 


108 


Scanned by CamScanner 




saV e the program as a binary file enter:- 


fO 
tfB 

gfftRT 9000H 
sT0 P 905AH 
t0 AD 9000H 
E XEC 9000H 

a nd 9 ive the loader the name of the main program that will follow it 
on tape* Afterwhich rewind the tape and verify by entering 'VB' and 
'RETURN 1 t and if all is well move the tape on slightly to allow a 
gap between the end of the loader and the start of the second 

program. 

Also, as a safety measure, save the ASCII file of this loader 
program on a separate tape for other programs and also in case it 
does not operate correctly when the second program is appended. 


N0W kill the file by entering 'K' and 'RETURN', similar to 'NEW' in 
Basic, and load in or enter from the keyboard the main program. If 
one saved the ASCII file of one of the earlier example programs m 
chapter 3 this will be ideal tor testing. Alter the ORG and LOAD of 
the second program to 9000H, the same address as the loader use , 

and assemble to (V)ideo in order to note the last y e o 

a „„ as previously shown onto the same tape that 
program an press 'RETURN' when prompted for a 
contains the loader program, but press 

name. 


To test switch off f° r 
enter: - 

BL0AD"CAS:" ,R 
and the first program found on 


few seconds, and when turned back on 


he tape will load and run, 
and the first program found on automatically load and 
displaying the titles, and in dorng so shoul 

run the second, main program. 
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Argument Transfer using USR 


The USR function was used in chapter 1 with what is termed as 

$ 

dummy argument within the brackets i.e. USR(O). It is possible 
pass up to a machine code routine an integer, string, single 
double precision variable. A=USR(&H1234) would store in a storage 
area in RAM the hex value 1234 and call up the machine code routine 
Misuse of this function could cause a program to crash. 

The type of argument passed to the routine is always stored at 
address F663, so the routine can check what type has been passed up ( 
and would contain 

2 for an integer 

3 a string 

4 a single precision real type variable 
8 a double precision real type variable. 

Take an example 

First one needs to DEFine the USeR address as was shown in chapter 1 
(i.e. 10 DEF USR2=&HE000). Our machine code routine is called from 
Basic to execute a certain task, it could be to move a block of 
memory, and requires the destination address (for example A020H) to 
be passed from the Basic program and stored in order to load into 
register DE. The Basic line could be:- 
100 A=USR2(&HA020) 

This would then call the machine code routine at address E000H and 
carry out any tasks until it RETurned to the Basic program. The 
integer (or address) A020H is always stored at address F7F8 and F7F9 

hex. Therefore to load the integer into register DE all the machine 
code program needs to do is:- 
LD DE,(0F7F8H) 

and DE will contain A020H. If, „ hlle stiu in the machine c0 * 

routine, one wished to alter the integer and pass it back down to 
the Basic program when it RETurns simplyj- 
LD (F7F8H),DE 

and the new value will be Dlar^d 

P ed into variable A on returning to the 

Basic program. 





wrings operate in a slightly different manner in that F7F8 and F7F9 
tie* con tain NOT the string, but an address where the string 

£ j e sctiP^ or is located. This string descriptor contains 3 bytes, 
fhe fi rs *- signifies the string's length and the second and third the 
a ddr eSS w ^ ere it is stored, and could be used thus:- 

•100 B$ = "MSX" 

110 A$=USR2(B$) 

This time, as it is a string, F663H contains the value 3. Addresses 
p7F8 and F7F9 hex contain the address of the descriptor, for example 
g02D f and a *- address 802D will be the length of the string, 3, while 
802E and 802F will contain the actual location where the string is 
stored in reverse order naturally. Did I mention it was complicated? 

Single precision values, type 4, are stored at F7F6 to F7F9 hex and 
Double precision, type 8, at F7F6 to F7FD hex. 

WARNING One cannot access the storage addresses (F7F6H onwards) 
Ifter the routine has returned to the Basic program (they cannot be 
PEEKed), as they will not be stored. Only the variable which was 
used in the USR line (in the last example A$) will contain the data. 

For an example of how an integer would be passed into a machine code 
routine load ZEN in the normal way, and enter this short program:- 


1 ORG 0E000H 

2 LOAD 0E000H 

3 LOOP:EQU 0A003H 

4 LD DE,(0F7F8H) 

5 JP LOOP 

6 END 

7 . 


and assemble. 


Ill 




If all is 

program z - 


well enter 'B' to return to Basic 


and enter 


this 



10 DEFUSR2=&HA000 

20 A=USR2(&H1 234) 
30 PRINT HEX$(A) 
and RUN. 


am will enter the ZEN mainloop so enter:- 
The program will entei 

, 4 . The short program will execute 

GE0 00H ana 'RETURN' twrce «. s ^ ^ ,,, ^ 

immediately and return ““ * find DE cont ains 1 234, which 

examine the registers and one will 

proves that an integer can be passed up to routi . 

To discover how it passes back an integer enter 'MF7F8H' and the 

T ° , , Enter 35H and 'RETURN followed 

contents will be displayed as 34. Enter * 

by the full stop and 'RETURN' which alters the contents of 

memory, as you will obviously know by now. Enter 'B' to return to 
Basic and line 30 will then execute and print the hex value of 
variable A, which one will see has changed to 1 235H. 


The 'Q' command in ZEN is useful for displaying the contents of 
memory and could be used here to discover how the single and double 
precision variables are stored, as once control is passed back to 
Basic the storage area is corrupted. 


This section lists some of the useful routines found in ROM which 
ca n be used by y° ur own machine code program, some have been used 
previous chapters, and some may be too advanced for ones 
^mediate use. 

The start of ROM contains a table of jumps to the various routines, 
s0 me the more straightforward have been listed to assist if one 
w i S hes to disassemble certain sections of memory, but normally a 
ca ll to the appropriate location in the table is all that will be 
required, providing one knows which registers should be loaded with 
the relevant data before the call is made. Each routine carries an 
abbreviated name, or label up to six characters in length, as used 
in the MSX specification. 

Addr Jump Name Function 

0000 02D7 CHKRAM The first byte disables the interrupts and a jump 

to 02D7 checks RAM and sets slots for the command 
area, this is followed by the address of the 
character generator table and also the ports for 
VDP read and write. 

0008 2683 SYNCHR Called by RST 8. Checks the current character 

pointed to by HL is the required one and falls 
into CHRGTR if true, else gives Syntax error. 
Character to be checked must be the next byte 
after this RST. Carry flag set if it is a number, 

Z flag set if end of statement. 

Modifies AF,HL 

0010 2686 CHRGTR Gets next character, or basic token, in basic 

text. Entry HL. Exits with HL pointing to next 
char, A contains char, carry flag set if number, Z 
flag set if end of statement. 

Modifies AF,HL 
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Addr Jump Name 
0018 1B45 OUTDO 

0020 146A DCOMPR 

0038 0C3C KEYINT 

0041 0577 DISSCR 

0044 0570 ENASCR 

0047 057F WRTVDP 

004A 07D7 RDVRM 

004D 07CD WRTVRM 

0050 07EC SETRD 

0053 07DF SETWRT 

0056 0815 FILVRM 


Function 


Outputs contents of reg A to current device, VDu 
printer etc. Called by RST 18H 

Compares HL with DE and sets Zero flag if matches 
Modifies AF 

Performs hardware interrupt procedure 50 times a 
second. 

Modifies nothing. 

Disables screen, blanks out screen. 

Modifies AF, BC 

Enables screen, switches it back and restores 
characters which were previously displayed. 
Modifies AF, BC 

Writes data to VDP register. Enter with reg in C, 
data in B 

Modifies AF, BC 

Reads VRAM pointed to by HL, returns data in reg 
A. 

Modifies AF 

Writes to VRAM pointed by HL, data in reg A. 
Modifies AF 

Sets up VDP for Read. HL on entry. 

Modifies AF 

Sets up VDP for Write. HL on entry. 

Modifies AF 

Fills VRAM starting at HL with data in reg A and 
length in BC. 

Modifies AF, BC 
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0 dr Jump Name 
0 059 070P LDIRMV 

005C 0744 LDIRVM 

005F 084F CHGMOD 

0062 07F7 CHGCLR 

0066 1398 NMI 

0069 06A8 CLRSPR 

006C 050E INITXT 

006F 0538 INIT32 

0072 05D2 INIGRP 

0075 061F INIMLT 



Function 


Moves block of 

to destination 
Modifies all. 


ln and lengt 


VRA M source 
in BC. 


in hl 


- —or memory tn 

:ZT a T on in - tn * - 


in BC. 


Initialises screen 
to 3. Stores A at 
Modifies all. 


according to value 
FCAFH. 


of 


reg A, 


0 


Changes colour of screen to colours specified in: 

ground colour (FORCLR, at F3E9, Background 

at F3EA and Border (BDRCLR) at F3EB 
Modifies all. 


Performs non-maskable Interrupt procedure. Entry 
none. 

Modifies none. 


Initialises all sprites. Patterns are set to 
nulls. 


Initialises screen to text mode, screen 0 and sets 
VDP. 

Modifies all. 


Initialises for screen 1 , and sets VDP 
Modifies all. 


Initialises to screen 2, and sets VDP 
Modifies all. 


Initialises to screen 3, 
Modifies all. 


and sets VDP. 
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Addr Jump Name Function 

0078 0594 SETTXT Sets VDP for screen 0 

007B 05B4 SETT32 Sets VDP for screen 1 

007E 0602 SETGRP Sets VDP for screen 2 

0081 0659 SETMLT Sets VDP for screen 3 

0084 06E4 CALPAT Returns address of sprite pattern table in HL. 

Entry reg A = sprite no. 

Modifies AF, DE, HL. 

0087 06F9 CALATR Returns address of sprite attribute table in HL. 

Entry sprite no. in reg A. 

Modifies AF, DE, HL. 

008A 0704 GSPSIZ Returns current sprite size in reg A (no. of 

bytes) Returns carry flag set if 16x16 sprite 
otherwise reset. 

Modifies AF. 

008D 1510 GRPPRT Prints a character on graphic screen in reg A. 

0090 04BD GICINI Initialises PSG. 

Modifies all. 

0093 1102 WRTPSG Write data in reg E to PSG register number in A. 

0096 110E RDPSG Reads data from PSG register in A, returns with 

data in A. 

Modifies AF. 

0099 11C4 STRTMS Checks and starts the background music. 

009C 0D6A CHSNS Checks the keyboard for pressed key. Returns with 

Z flag set if key in buffer. 

Modifies AF. 
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^ juee HSES i ? unctl? - 

9 f 10CB CHGET Waits until a key is typed. Returns with ASCII of 
“ key in reg A. 

Modifies AF. 

0 0 A 2 <> 8BC CHPUT Outputs contents of reg A to screen. 

qOA 8 085D LPTOUT Outputs contents of reg A to printer. Carry flag 

set if aborted. 

Modifies F. 

0 OA 8 0884 LPTSTT Checks printer status. Returns FFhex in A and Z 

flag reset if printer ready, 0 in A and Z flag set 
if not ready. 

Modifies AF. 

OOAE 23BF PINLIN Stores line of input from keyboard in buffer, 

terminates when RETURN entered. Returns start of 
buffer in HL, carry flag set if STOP was entered. 

Modifies all. 


00B7 

046F BREAKX 

Checks for CTRL/STOP keys. Carry flag set if 



pressed. 

Modifies AF. 

OOCO 

1113 BEEP 

Sounds bell. 

00C3 

0848 CLS 

Clears screen if Z £1*9 set ' 

00C6 

088E POSIT 

Entry H=column, L=line. 
Positions the cursor. Entry 

Modifies AF. 

00C9 

0B26 FNKSB 

x Hnn k eys should be on, if so 

rhprks if function Keys 

4 -hf»m else does nothing, 
displays them, else 



Modifies all. 

OOCC 

OBI 5 ERAFNK 

Turns off function key display. 

Modifies all. 
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Function 


£g? dr Jump Name 

OOCF 0B2B DSPFNK Turns on function key display. 

Modifies all. 

00D2 083B TOTEXT Forces screen into text mode. 

Modifies all. 

0132 0F3D CHGCAP Switches CAPS light on/off, but does not affect 

CAP status. Entry 0 in reg A turns on, any other 

turns off. 

Modifies AF. 

0156 0468 KILBUF Clears keyboard buffer. 

Modifies HL. 

Addresses F380H upwards are assigned to storage areas for 
accessing from ROM or equally from your own program in RAM. The 
more common of which are listed below followed by their MSX name and 
amount of bytes and purpose. 

For example the current line length of screen 0 is held at F3AEH, 
and is usually set to 25H (37 dec) and can naturally be altered as 
this is in RAM. To check on the contents of a location in memory 
one could enter a Basic line:- ?PEEK(&HF3AE) or from ZEN :-QF3AEH. 


Addr Name Size Function 

F39A USRTAB 20 Addresses assigned to the 10 USR functions (0 to9). 

Until a DEF USR statement been initialised these 
addresses all contain 475A which loads error 5 into 

the error flag. 


F3AE LINL40 
F3AF LINL32 


1 Line width in screen 0 
1 Line width in screen 1 


lift 
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^ddr Name S 
f3B 0 LINLEN 
f3B 2 CLMLST 

f3B 3 TXTNAM 
F 3B5 TXTCOL 
F 3B7 TXTCGP 
F 3B9 TXTATR 
F 3BB TXTPAT 

F3BD T32NAM 
F3BF T32COL 
F3C1 T32CGP 

F3C3 T32ATR 

F3C5 T32PAT 

F3C7 GRPNAM 

F3C9 GRPCOL 
F3CB GRPCGP 
F3CD GRPATR 
p 3CF GRPPAT 


Lze Function 


1 Line length. 


1 Lines on screen, 


Screen 0 

2 Name address table start. 


(0000H) 


2 Colour " 


(unused) 


2 Character Generator table start (0800H) 


2 Attribute Table start 


(unused) 


2 Sprite Pattern Generator table start (unused) 


Screen 1 

2 Name address table start, 


(1800H) 


2 Colour " 


II II 


(2000H) 


2 Character Generator table start (OOOOH) 


2 Attribute Table start 


(1 BOOH) 


2 Sprite Pattern Generator table start (3800H) 


Screen 2 

Name address table start. 


(1800H) 


2 Colour " 


(2000H) 


2 Character Generator table start (OOOOH) 


2 Attribute Table start 


(1 BOOH) 


l Sprite Pattern Generator table start (3800H) 
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Addr Name 

Size Function 


F3D1 MLTNAM 

2 

Screen 3 

Name address table start. 

(0800H) 

F3D3 MLTCOL 

2 

, M » " 

Colour 

(unused) 

F3D5 MLTCGP 

2 

Character Generator table start (0000H) 

F3D7 MLTATR 

2 

Attribute Table start 

(1B00H) 

F3D9 MLTPAT 

2 

Sprite Pattern Generator table start (3800H) 

F3DB CLIKSW 

1 

Key click switch. 0=off, an Y 

other=on 

F3DC CSRY 

1 

Cursor Y position (line) 


F3DD CSRX 

1 

Cursor X position (column) 


F3DE CNSDFG 

1 

Function key display switch. 

0=of f 



VDP Register values 


F3DF to 

8 

Stores VDP 0 to VDP 7 


F3E6 




F3E7 STATFL 

1 

Stores VDP Status register 


F3E9 FORCLR 

1 

Foreground colour 


F3EA BAKCLR 

1 

Background colour 


F3EB BDRCLR 

1 

Border colour 


F55E BUF 

256 

Input Buffer 


F672 MEMSIZ 

2 

Highest location in memory 
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Bytesearcher 


This utility program i s loa<Jed 

search routine which Is use(ul ™ simply ap pen a s . byte 

memory. One can either search f or a dlsasse "*lihg sections of 

t“o byte address or string. 

Two byte search 

The keyboard routine within zen 

us suppose one wanted to discover^h 068 ^ addr6SS A742H ' and let 
routine was referred to within the W *"* h °* ° ften the Aboard 
One would enter:- memory area which ZEN occupies. 

YA742H 

Note that the address 

UieiS 1 s entered correctlv 

in memory low byte first as n ° as ifc would be found 

The command 'y' has been'used ** 6 routine adjusts for this. 

utilised, although this could be aulredTT letterS 

(small) letter such as ’s' which • i. ln lne 11 to a lower case 

cn as s which is not otherwise used. 

r Pr0 " Pted t0 entar tha '«*«• address followed hy 

ZEN: _ ” aS ^ SearChe<J the £irst location of 

aoooh 

logically the next prompt is for 'END', so in this example one could 
nter the last address of ZEN:- 
BB5CH 

The final prompt is for 'OPTION* and for the screen to display the 
locations one would enter 'V'. The screen will then display:- 

°ccurences of A742H 
between:-A000 and BB5C 

a ?F4 A92A 
ZEN 
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String search 


Strings may be searched for by entering the string within quotes- 
Y"Ok" 

which will search for the 'Ok' message. To find its location wi thi 
the ROM one would enter the Start address as '0000' or simply 'q^ 

and for the End address enter the top of ROM '8000H'. The sere 
would then display:- 6n 

Occurences of "ok" 
between:-0000 and 8000 

3FD7 

ZEN 

which is the location in ROM where this message resides. 

The two byte search could then be used to discover which areas of 
the ROM access the 'Ok' message by searching for 3FD7 between 0 and 
8000H, and the display would reveal that it is referred to at:- 
412F 53FB and 7072 

Bytesearcher accesses many routines within ZEN only once calling a 
routine outside at 0020H which is a ROM routine to compare HL with 
DE f and the routines are listed in the comment field and may be 
checked against your ZEN reference manual. 

The program can be saved as an ASCII file, where one simply enters 
W and enters the filename, and can be loaded back in and assembled 
only when one requires the extra byte search facility, for 
disassembling. 

MTE After entering the code, or loading from tape, it is 
essential to assemble the bytesearcher BEFORE modifying the 3 
bytes at A251H, as this area is within the mainloop of ZEN and a 
jump is made to E000H to discover if the key pressed was 'Y', and 
if it has not been assembled the bytesearcher program will not be 
at E000H and ZEN could crash and the program lost. 
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?BYTESEARCHER 
;AFTER ASSEMBLY ALTER 
;ZEN BY:- M0A251H 
;and enter these 3 bytes 
;0C3H 00 0E0H 

f 

ORG 0E000H 
LOAD 0E000H 


jq E00° CAAb 

„ E003 FE59 
)2 £005 2803 

13 

14 

15 

16 E007 C354A2 

17 

18 EOOA 118AA1 

19 EOOD 21D6E0 

20 E010 01 0000 

21 
22 
23 


CAA5A3 EXTRA: 


31 

32 

33 

34 

* 5 E01C 
E01D 
37 E01E 


JP Z,OA3A5H 

CP "Y" 

JR Z r BYTSCH 


New commands go here 

jp 0A254H 


BYTSCH: LD DE,0A18AH 

LD HL,SCHSTR 
LD BC,0 


Transfer the string 


24 

E013 

1A 

TRSTR: 

LD 

A,(DE) 

25 

E01 4 

77 


LD 

(HL) ,A 

26 

E01 5 

23 


INC 

HL 

27 

E01 6 

13 


INC 

DE 

28 

E01 7 

03 


INC 

BC 

29 

E01 8 

FEOD 


CP 

ODH 

30 

eoia 

20F7 


JR 

NZ,TRSTR 


Transfer complete-Check that 
something is there 


;Orig routine 
;For Bytesearcher 
; 11's what we want 


;Back to Zen 

; (TBUFF + 1 ) 

; Store Input 
;String counter 


;Return? 

;No-keep transfering 


/Don't count 'CR* 
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38 E01F CAD5A8 

39 

40 

41 


jp Z , 0A8D5H 

NOW get START/STOP parameters 


48 

49 

50 


E022 

CDC5A8 

CALL 

0A8C5H 

E025 

2B 

DEC 

HL 

E026 

19 

ADD 

HL/DE 

E027 

ED532CA1 

LD 

(0A12CH),DE 

E02B 

222EA1 

LD 

(0A12EH),HL 

E02E 

CD39AB 

CALL 

0AB39H 



J 

jPrint title 


E031 

21E0E0 

/ 

LD 

HL,MSG1 

E034 

CDDCA7 

CALL 

0A7DCH 

E037 

21D6E0 

LD 

HL,SCHSTR 

E03A 

CDDCA7 

CALL 

0A7DCH 


35 E03D 21EFE0 

56 E040 CDC4A6 

57 E043 CDDCA7 

58 E046 2A2CA1 

59 E049 CD95A9 
50 E04C 21F9E0 

61 E04F CDDCA7 

62 E052 2A2EA1 

63 E055 CD95A9 

64 E058 CDC4A6 

65 E05B CDC4A6 

66 

67 

68 


LD 

CALL 

CALL 

LD 

CALL 

LD 

CALL 

LD 

CALL 

CALL 

CALL 


HL,MSG2 

0A6C4H 

0A7DCH 

HL , (0A12CH) 

0A995H 

HL,MSG3 

0A7DCH 

HL#(0A1 2EH) 

0A995H 

0A6C4H 

0A6C4H 


Che ° k f ° r ” ° r °“°t e at ena 


;Error, so 'huh?' 


;'STARTSTOP' 


;=START 
? =STOP 


;ZEN "STR1" 


/Start of Data 
;ZEN "WORDSP" 


/End of Data 

;ZEN "CRLF" 

;another CRLF 


E05E 21D6E0 

E °61 0600 

LD 

HL /SCHSTR 


E063 7e 

LD 

B/0 


t,« PENDS: 

E064 feod 

LD 

A/(HL) 

?Counter for convert 

e °66 2804 

CP 

0DH 

/Find string end 

E068 23 

JR 

Z,COMP 



INC 

hl 
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E 069 04 
g06A 18F7 

| i 

^ g 0 6 C 2B COMP: 

I g 06 D 7E 

, E 06E FE22 
, £070 281 6 
x E 072 FE48 

3 e07 4 C2D5A8 

4 E077 23 

5 E 078 1 1D6E0 
e q7B CDDAA 8 

? e 0 7E 22D7E0 
|8 e o81 3E0D 
| 9 e0 83 32D9E0 
)0 E086 1 802 

)1 ; 

)2 E088 360D SEEK: 

93 E08A 2A2CA1 FIND: 

34 E08D ED5B2EA1 

35 E091 2B 

96 E092 D5 

97 E093 E5 

98 ; 

99 E094 AF 

00 ; 

01 E095 32D5E0 
02 E098 El FINDIT: 

03 E099 D1 
04 E09A 23 
05 E09B D5 
06 E09C E5 
°7 E09D CD2000 
08 EOAO 2008 
E0A2 El 
“’0 E0A3 D1 
!*1 E0A4 CDC4A6 


INC 

B 

JR 

FENDS 

DEC 

HL 

LD 

A,(HL) 

CP 

22H 

JR 

Z,SEEK 

CP 

"H" 

JP 

NZ , 0A8D5H 

INC 

HL 

LD 

DE,SCHSTR 

CALL 

0A8DAH 

LD 

(SCHSTR+1),HL 

LD 

A, ODH 

LD 

(SCHSTR+3),A 

JR 

FIND 

LD 

(HL),ODH 

LD 

HL,(0A12CH) 

LD 

DE,(0A12EH) 

DEC 

HL 


PUSH DE 
PUSH HL 


XOR A 


LD 

(COUNT),A 

POP 

HL 

POP 

DE 

INC 

HL 

PUSH 

DE 

PUSH 

HL 

CALL 

0020H 

JR 

NZ,LOOK 

POP 

HL 

POP 

DE 

CALL 

0A6C4H 


;Back-up to 'H' or 
jit's a quote string 

;Not hex 
jBack to end 

;ZEN convert routine 


J ROM Compare HL'DE 


jFinished so CRLF 
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jp OAOOOH 


;Back to ZEN 


112 E0A7 C300A0 

113 • 

114 EOAA 11D7E0 LOOK: 

115 EOAD 1A LOOKIT: 

116 EOAE FEOD 

117 EOBO 2807 

118 E0B2 BE 

119 E0B3 20E3 

120 E0B5 13 

121 E0B6 23 

122 E0B7 18F4 

123 ? 

124 E0B9 El FOUND: 

125 EOBA E5 

126 EOBB CD95A9 

127 EOBE 3AD5E0 

128 E0C1 3C 

129 E0C2 FE05 

130 E0C4 32D5E0 

131 E0C7 20CF 

132 E0C9 AF 

133 EOCA 32D5E0 

134 EOCD CDC4A6 

135 EODO 18C6 

136 ; 

137 E0D2 C300A0 

138 E0D5 00 COUNT: 

139 SCHSTR: 

140 EOEO 4F636375 MSG1: 

140 E0E4 72656E63 

140 E0E8 6573206F 

140 EOEC 66200D 

141 EOEF 62657477 MSG2: 

141 E0F3 65656E3A 

141 E0F7 2D0D 

142 E0F9 616E6420 MSG3: 

142 EOFD OD 

1 43 


LD 

DE,SCHSTR+1 

LD 

A,(DE) 

CP 

ODH 

JR 

Z,FOUND 

CP 

(HL) 

JR 

NZ,FINDIT 

INC 

DE 

INC 

HL 

JR 

LOOKIT 

POP 

HL 

PUSH 

HL 

CALL 

0A995H 

LD 

A,{COUNT) 

INC 

A 

CP 

5 

LD 

(COUNT),A 

JR 

NZ,FINDIT 

XOR 

A 

LD 

(COUNT),A 

CALL 

0A6C4H 

JR 

FINDIT 


;Address this srch 
;Restack it 


JP OAOOOH 
DB 0 
DS 10 

DB "Occurences of ",0DH 


DB "between:-",0DH 


DB "and ",0DH 


END 


Appendix 


eSLtoOPCODE^onverslo^T^ 

This first table is to assist when one kn 
i wishes to know the opcode and the amount" 0 ^ ^ Value and 
followed by. When one attempts to convert ^ bYt6S U Should *>e 
dA TA statements to Opcodes and Operands be Clmal Values in Basic 
first byte in the routine, else one could 6 ^ SUrt with th * 

As an example take program 1 in chapter V falSS infonnation * 
dA TA line has the decimal value of 62 ^ ^ fifSt byte in th e 

will see it is 3Ehex. No „ look tn thls to hex and one 

signifies. It is LD A,nn which means load l0 ” to ,ind “hat 3E 

of the next byte which is 66 dec (42hex) ^ ^ w ith the value 

third value in the DATA line which is 3 T v l. h N °“ C ° ntinue with the 
checking below one will see it ° COnverts to 21 hex. On 

the next two by tes ioaded in^ 

- - *«• - - r::r 66 


the table nn 

equals a one byte 

value in the range 

OOh to FF 

255 dec) and 

bb aa two bytes in 

the same range. 


00 

NOP 

OC 

INC C 

01 bb aa 

LD BC,aabb 

0D 

DEC C 

02 

LD (BC),A 

0E nn 

LD C,nn 

03 

INC BC 

OF 

RRCA 

04 

INC B 

10 nn 

DJNZ nn 

05 

DEC B 

11 bb aa 

LD DE,aabb 

06 nn 

LD B,nn 

12 

LD (DE), A 

07 

RLCA 

13 

INC DE 

08 

EX AF,AF 1 

14 

INC D 

09 

ADD HL,BC 

15 

DEC D 

0A 

LD A,(BC) 

1 6 nn 

LD D,nn 

0B 

DEC BC 

17 

RLA 
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18 nn 

19 
1A 
IB 
1C 
ID 

IE nn 
IF 

20 nn 

21 bb aa 

22 bb aa 

23 

24 

25 

26 nn 

27 

28 nn 

29 

2A bb aa 

2B 

2C 

2D 

2E nn 
2F 

30 nn 

31 bb aa 

32 bb aa 

33 

34 

35 

36 nn 

37 

38 nn 

39 

3A bb aa 

3B 

3C 


JR nn 
ADD HL,DE 
LD A,(DE) 

DEC DE 
INC E 
DEC E 
LD E,nn 
RRA 

JR NZ,nn 
LD HL,aabb 
LD (aabb), HL 
INC HL 
INC H 
DEC H 
LD H,nn 
DAA 

JR Z,nn 
add HL,HL 
LD HL,(nn) 
DEC HL 
INC L 
DEC L 
LD L,nn 
CPL 

JR NC,nn 
LD SP,aabb 
LD (aabb), a 
INC SP 
INC (HL) 

°EC (HL) 

LD (HL), nn 

SCF 

JE C,nn 
AD D HL,SP 

LD A,(aabb) 
DEC SP 
INC A 


3D 

3E nn 
3F 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 
4A 
4B 
4C 
4D 
4E 
4F 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 
5A 
5B 
5C 
5D 
5E 
5F 

60 
61 


LD A,nn 
CCF 

LD B,B 
LD B,C 
LD B,D 
LD B,E 
LD B,H 
LD B,Ln 

LD B,(HL) 
LD B,A 
LD C,B 
LD C,C 
LD C,D 
LD C,E 
LD C,H 
LD C 
LD C 
LD C 
LD D 
LD D 
LD D 
LD D 
LD D 
LD D 
LD D 
LD D 


LD E,B 
LD E,C 
LD E,D 


LD 

LD 

LD 

LD 

LD 

LD 

LD 


(HL) 

A 

B 

C 

D 

E 

H 

L 

(HL) 

A 


E,E 

e,h 
e,l 

E,(HL) 

e,a 

H,B 

H,C 
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62 

LD H, D 

LD H.E 

85 

86 

63 


LD H.H 

87 

64 


LD H,L 

88 

65 

66 

LD H r (HL) 

LD H,A 

89 

8 A 

67 


LD L.B 

8 B 

68 

69 

LD L,C 

8 C 

LD L.D 

8 D 

6 A 


LD L.E 

8 E 

hb 

6 C 

LD L f H 

8 F 

6 D 

LD L f L 

90 

6 E 

LD L r (HL) 

91 

6 F 

LD L,A 

92 

70 

LD (HL),B 

93 

71 

LD (HL),C 

94 

72 

LD (HL),D 

95 

73 

LD (HL) r E 

96 

74 

LD (HL) r H 

97 

75 

LD (HL),L 

98 

if* 

HALT 

99 


LD (HL),A 
LD A,B 
LD A,C 
LD A,D 
LD A ,E 
LD A,H 
LD A,L 
LD A,(HL) 
LD A, A 
ADD A ,B 
ADD A,C 
ADD A # D 
ADD A,E 
ADD A,H 


ADD A,L 
ADD A,(HL) 
ADD A,A 
ADC A,B 
ADC A,C 
ADC A,D 
ADC A,E 
ADC A,H 
ADC A,L 
ADC A,(HL) 
ADC A,A 
SUB B 
SUB C 
SUB D 
SUB E 
SUB H 
SUB L 
SUB (HL) 
SUB A 
SBC A,B 
SBC A,C 
SBC A,D 
SBC A,E 
SBC A,H 
SBC A,L 
SBC A,(HL) 
SBC A,A 
AND B 
AND C 
AND D 
AND E 
AND H 
AND L 
AND (HL) 
AND A 
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A8 

A9 

AA 

AB 

AC 

AD 

AE 

AF 

BO 

B1 

B2 

B3 

B4 

B5 

B6 

B7 

B8 

B9 

BA 

BB 

BC 

BD 

BE 

BF 

CO 

Cl 

C2 bb 
C3 bb 
C4 bb 
C5 

C6 nn 
C7 
C8 
C9 

CA bb 


XOR B 
XOR C 
XOR D 
XOR E 
XOR H 
XOR L 
XOR (HL) 

XOR A 
OR B 
OR C 
OR D 
OR E 
OR H 
OR L 
OR (HL) 

OR A 
CP B 
CP C 
CP D 
CP E 
CP H 
CP L 
CP (HL) 

CP A 
RET NZ 
POP BC 

JP NZ,aabb 
UP aabb 
CALL NZ,aabb 
PUSH BC 
ADD A,nn 
RST 00 
RET z 
RET 

Jp Z,aabb 


CB 00 
CB 01 
CB 02 
CB 03 
CB 04 
CB 05 
CB 06 
CB 07 
CB 08 
CB 09 
CB 0A 
CB 0B 
CB 0C 
CB 0D 
CB 0E 
CB OF 
CB 10 
CB 11 
CB 12 
CB 13 
CB 14 
CB 15 
CB 16 
CB 17 
CB 18 
CB 19 
CB 1 A 
CB IB 
CB 1C 
CB Id 
CB IE 
CB ip 
CB 20 
CB 21 
CB 22 


RLC B 
RLC C 
RLC D 
RLC E 
RLC H 
RLC L 
R LC (HL) 
RLC A 
RRC B 
RRC C 
RRC D 
RRC E 
RRC H 
RRC L 
RRC (HL) 
RRC A 
RL B 
RL C 
RL D 
RL E 
RL H 
RL L 
RL (HL) 

RL A 
RR B 
RR C 
RR D 
RR E 
RR H 
RR L 
RR (HL) 

RR A 
SLA B 
SLA C 
SLA D 
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CB 23 
CB 24 
CB 25 
CB 26 
CB 27 
CB 28 
CB 29 
CB 2A 
CB 2B 
CB 2C 
CB 2D 
CB 2E 
CB 2F 
CB 30 
CB 31 
CB 32 
CB 33 
CB 34 
CB 35 
CB 36 
CB 37 
CB 38 
CB 39 
CB 3A 
CB 3B 


SLA E 
SLA H 
SLA L 
SLA (HL) 
SLA A 
SRA B 
SRA C 
SRA D 
SRA E 
SRA H 
SRA L 
SRA (HL) 
SRA A 
SLI B 
SLI C 
SLI D 
SLI E 
SLI H 
SLI L 
SLI (HL) 
SLI A 
SRL B 
SRL C 
SRL D 
SRL E 
SRL H 
SRL L 
SRL (HL) 
SRL A 

bit o,b 

BIT 0,C 
BIT o,d 
bit o,e 
bit 0,H 
BIT 0,L 


CB 46 
CB 47 
CB 48 
CB 49 
CB 4A 
CB 4B 
CB 4C 
CB 4D 
CB 4E 
CB 4F 
CB 50 
CB 51 
CB 52 
CB 53 
CB 54 
CB 55 
CB 56 
CB 57 
CB 58 
CB 59 
CB 5A 
CB 5B 
CB 5C 
CB 5D 
CB 5E 
CB 5F 
CB 60 
CB 61 
CB 62 
CB 63 
CB 64 
CB 65 
CB 66 
CB 67 
CB 68 


BIT 0,(HL) 
BIT 0,A 
BIT 1 ,B 
BIT 1,C 
BIT 1,D 
BIT 1,E 
BIT 1/H 
BIT 1fL 
BIT 1,(HL) 
BIT 1,A 
BIT 2,B 
BIT 2,C 
BIT 2,D 
BIT 2,E 
BIT 2 ,H 
BIT 2,L 
BIT 2,(HL) 
BIT 2,A 
BIT 3,B 
BIT 3,C 
BIT 3,D 
BIT 3 f E 
BIT 3,H 
BIT 3,L 
BIT 3,(HL) 
BIT 3,A 
BIT 4 ,B 
BIT 4,C 
BIT 4 ,D 
BIT 4 f E 
BIT 4,H 
BIT 4,L 
BIT 4,(HL) 
BIT 4,A 
BIT 5 ,B 


131 

Scanned by CamScanner 


CB 

69 

bit 

5,C 

CB 

6A 

BIT 

5,D 

CB 

6B 

BIT 

5,E 

CB 

6C 

BIT 

51H 

CB 

6D 

BIT 

5,L 

CB 

6E 

BIT 

5,(HL) 

CB 

6F 

BIT 

5,A 

CB 

70 

BIT 

6,B 

CB 

71 

BIT 

6,C 

CB 

72 

BIT 

6,D 

CB 

73 

BIT 

6 r E 

CB 

74 

BIT 

6 ,H 

CB 

75 

BIT 

6 ,L 

CB 

76 

BIT 

6, (HL) 

CB 

77 

BIT 

6,A 

CB 

78 

BIT 

7,B 

CB 

79 

BIT 

7,C 

CB 

7A 

BIT 

7,D 

CB 

7B 

BIT 

7,E 

CB 

7C 

BIT 

7,H 

CB 

7D 

BIT 

7,L 

CB 

7E 

BIT 

7 *(HL) 

CB 

7F 

BIT 

7, A 

CB 

80 

RES 

0,B 

CB 

81 

RES 

o,c 

CB 

82 

RES 

0,0 

CB 

83 

RES 

0 ,E 

CB 

84 

RES 

0 ,H 

CB 

85 

RES 

0,L 

CB 

86 

RES 

0,(HL) 

CB 

87 

RES 

0,A 

CB 

88 

RES 

1 ,B 

CB 

89 

RES 

1 ,c 

CB 

8A 

RES 

1 ,D 

CB 

8B 

RES 

1 ,E 


CB 

8 C 

RES 

1 ,H 

CB 

8D 

RES 

1 #1* 

CB 

8E 

RES 

1 /(HL) 

CB 

8F 

RES 

1,A 

CB 

90 

RES 

2,8 

CB 

91 

RES 

2,C 

CB 

92 

RES 

2,D 

CB 

93 

RES 

2,E 

CB 

94 

RES 

2 ,H 

CB 

95 

RES 

2 ,L 

CB 

96 

RES 

2, (HL) 

CB 

97 

RES 

2, A 

CB 

98 

RES 

3,B 

CB 

99 

RES 

3 ,C 

CB 

9A 

RES 

3, D 

CB 

9B 

RES 

3 ,E 

CB 

9C 

RES 

3 ,H 

CB 

9D 

RES 

3 »L 

CB 

9E 

RES 

3,(HL) 

CB 

9F 

RES 

3,A 

CB 

AO 

RES 

4 ,B 

CB 

A1 

RES 

4,C 

CB 

A2 

RES 

4 ,D 

CB 

A3 

RES 

4,E 

CB 

A4 

RES 

4 ,H 

CB 

A5 

RES 

4 ,L 

CB 

A6 

RES 

4,(HL) 

CB 

A7 

RES 

4,A 

CB 

A8 

RES 

5 ,B 

CB 

A9 

RES 

5 ,C 

CB 

AA 

RES 

5 ,D 

CB 

AB 

RES 

5 ,E 

CB 

AC 

RES 

5 ,H 

CB 

AD 

RES 

5 ,L 

CB 

AE 

RES 

5,(HL) 
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CB 

AF 

RES 

5,A 

CB 

BO 

RES 

6,B 

CB 

B1 

RES 

6,C 

CB 

B2 

RES 

6,D 

CB 

B3 

RES 

6, E 

CB 

B4 

RES 

6 ,H 

CB 

B5 

RES 

6,L 

CB 

B6 

RES 

6,(HL) 

CB 

B7 

RES 

6,A 

CB 

B8 

RES 

7,B 

CB 

B9 

RES 

7,C 

CB 

BA 

RES 

7 »D 

CB 

BB 

RES 

7 rE 

CB 

BC 

RES 

7 »H 

CB 

BD 

RES 

7 flj 

CB 

BE 

RES 

7»(HL) 


CB D2 
CB D3 
CB D4 
CB D5 
CB D6 
CB D7 
CB D8 
CB D9 
CB DA 
CB DB 
CB DC 
CB DD 
CB DE 
CB DF 
CB EO 


SET 2,D 
SET 2,E 
SET 2,H 
SET 2,L 

SET 2,(HL) 
SET 2,A 
SET 3 ,B 
SET 3,C 
SET 3 ,D 
SET 3,E 
SET 3,H 
SET 3,L 
SET 3,(HL) 
SET 3,A 
SET 4,B 


CB BF 

RES 

u -- r 

7, A 

v-b t; i 

CB E2 

SET 4 ,C 

SET 4 . D 

CB CO 

SET 

0,B 

CB E3 

SET 4,E 

CB Cl 

SET 

o,c 

CB E4 

SET 4,H 

CB C2 

SET 

0,D 

CB E5 

SET 4,L 

CB C3 

SET 

0, E 

CB E6 

SET 4,(HL) 

CB C4 

SET 

0,H 

CB E7 

SET 4,A 

CB C5 

SET 

0 ,L 

CB E8 

SET 5,B 

CB C6 

SET 

0,(HL) 

CB E9 

SET 5,C 

CB C7 

SET 

0 , A 

CB EA 

SET 5,D 

CB C8 

SET 

1 ,B 

CB EB 

SET 5,E 

CB C9 

SET 

1 ,C 

CB EC 

SET 5 f H 

CB CA 

SET 

1 ,D 

CB ED 

SET 5,L 

CB CB 

SET 

1 ,E 

CB EE 

SET 5,(HL) 

CB CC 

SET 

1 »H 

CB EF 

SET 5,A 

CB CD 

SET 

1 ,L 

CB FO 

SET 6 ,B 

CB CE 

SET 

1 ,(HL) 

CB FI 

SET 6,C 

CB CF 

SET 

1 , A 

CB F2 

SET 6,D 

CB DO 

SET 

2 ,B 

CB F3 

SET 6 ,E 

CB D1 

SET 

2,C 

CB F4 

SET 6,H 
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CB 

F5 

SET 6 ,L 

CB 

F6 

SET 6,(HL) 

CB 

F7 

SET 6,A 

CB 

F8 

SET 7 ,B 

CB 

F9 

SET 7,C 

CB 

FA 

SET 7 r D 

CB 

FB 

SET 7 ,E 

CB 

FC 

SET 7 ,H 

CB 

FD 

SET 7,L 

CB 

FE 

SET 7, (HL) 

CB 

FF 

SET 7, A 

CC 

bb aa 

CALL Z ,aabb 

CD 

bb aa 

CALL aabb 

CE 

nn 

ADC A,nn 

CF 


RST 08 

DO 


RET NC 

D1 


POP DE 

D2 

bb aa 

JP NC,aabb 

D3 

nn 

OUT (nn),A 

D4 

bb aa 

CALL NC,aabb 

D5 


PUSH DE 

D6 

nn 

SUB nn 

D7 


RST 10 

D8 


RET C 

D9 


EXX 

DA 

bb aa 

JP C,aabb 

DB 

nn 

IN A,(nn) 

DC 

bb aa 

CALL C,nn 

DD 

09 

add ix,bc 

DD 

19 

ADD IX,DE 

DD 

21 bb aa 

LD IX,aabb 

DD 

22 bb aa 

LD (aabb),ix 

DD 

23 

INC IX 

DD 

29 

add ix,ix 

DD 

2A bb aa 

LD IX,(aabb) 


DD 

2B 



DEC IX 

DD 

34 

nn 


INC (ix+nn) 

DD 

35 

nn 


DEC (IX+nn) 

DD 

36 

nn 

nl 

LD <IX+n n),ni 

DD 

39 



ADD IX,SP 

DD 

46 

nn 


LD B,(l X+nn) 

DD 

4E 

nn 


LD C,(ix +nn j 

DD 

56 

nn 


LD D,(i X+nn) 

DD 

5E 

nn 


LD E,(ix+nn) 

DD 

66 

nn 


LD H,(ix+nn) 

DD 

6 E 

nn 


LD L,(ix+nn) 

DD 

70 

nn 


LD (IX+nn) ( B 

DD 

71 

nn 


LD (IX+nn),c 

DD 

72 

nn 


LD (IX+nn),o 

DD 

73 

nn 


LD (IX+nn),E 

DD 

74 

nn 


LD (lx+nn),H 

DD 

75 

nn 


LD (IX+nn),L 

DD 

77 

nn 


LD (IX+nn),A 

DD 

7E 

nn 


LD A,(IX+nn) 

DD 

86 

nn 


ADD A,(IX+nn) 

DD 

8 E 

nr 


ADC A,(IX+nn) 

DD 

96 

nn 


SUB (IX+nn) 

DD 

9E 

nn 


SBC A,(IX+nn) 

DD 

A6 

nn 


AND (IX+nn) 

DD 

AE 

nn 


XOR (IX+nn) 

DD 

B6 

nn 


OR (IX+nn) 

DD 

BE 

nn 


CP (IX+nn) 

DD 

CB 

nn 

06 

RLC (IX+nn) 

DD 

CB 

nn 

0E 

RRC (IX+nn) 

DD 

CB 

nn 

16 

RL (IX+nn) 

DD 

CB 

nn 

IE 

RR (IX+nn) 

DD 

CB 

nn 

26 

SLA (IX+nn) 

DD 

CB 

nn 

2E 

SRA (IX+nn) 

DD 

CB 

nn 

36 

SLI (IX+nn) 

DD 

CB 

nn 

3E 

SRL (IX+nn) 
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-rr tfWgVp 


DD CB nn 46 

BIT 0 ,(IX+nn) 

E4 bb aa 

CALL PO,aabb 

D D CB nn 4E 

BIT 1,(IX+nn) 

E5 

PUSH HL 

D D CB nn 56 

BIT 2,(IX+nn) 

E6 nn 

AND nn 

DD CB nn 5E 

BIT 3,(IX+nn) 

E7 

RST 20 

pD CB nn 66 

BIT 4,(IX+nn) 

E8 

RET PE 

DD CB nn 6E 

BIT 5,(IX+nn) 

E9 

JP (HL) 

DD CB nn 76 

BIT 6,(IX+nn) 

EA bb aa 

JP PE,aabb 

DD CB nn 7E 

BIT 7, (IX+nn) 

EB 

EX DE,HL 

DD CB nn 86 

RES 0, (IX+nn) 

EC bb aa 

CALL PE,aabb 

DD CB nn 8E 

RES 1 , (IX+nn) 

ED 40 

IN B,(C) 

DD CB nn 96 

RES 2, (IX+nn) 

ED 41 

OUT (C) f B 

DD CB nn 9E 

RES 3, (IX+nn) 

ED 42 

SBC HL,BC 

DD CB nn A6 

RES 4, (IX+nn) 

ED 43 bb aa 

LD (aabb),BC 

DD CB nn AE 

RES 5, (IX+nn) 

ED 44 

NEG 

DD CB nn B6 

RES 6, (IX+nn) 

ED 45 

RETN 

DD CB nn BE 

RES 7 f (IX+nn) 

ED 46 

IM 0 

DD CB nn C6 

SET 0, (IX+nn) 

ED 47 

LD I,A 

DD CB nn CE 

SET 1 , (IX+nn) 

ED 48 

IN C,(C) 

DD CB nn D6 

SET 2,(IX+nn) 

ED 49 

OUT (C),C 

DD CB nn DE 

SET 3,(IX+nn) 

ED 4A 

ADC HL,BC 

DD CB nn E6 

SET 4,(IX+nn) 

ED 4B bb aa 

LD BC,(aabb) 

DD CB nn EE 

SET 5 f (IX+nn) 

ED 4D 

RET I 

DD CB nn F6 

SET 6,(IX+nn) 

ED 4F 

LD R , A 

DD CB nn FE 

SET 7, (IX+nn) 

ED 50 

IN D, (C) 

DD El 

POP IX 

ED 51 

OUT (C),D 

DD E3 

EX (SP),IX 

ED 53 bb aa 

LD (aabb),DE 

DD E5 

PUSH IX 

ED 56 

IM 1 

DD E9 

JP (IX) 

ED 57 

LD A,I 

DD F9 

LD SP,IX 

ED 58 

IN E,(C) 



ED 59 

OUT (C),E 

DE nn 

SBC A,nn 



DF 

RST 18 

ED 5A 

ADC HL,DE 

EO 

RET PO 

ED 5B bb aa 

LD DE,(aabb) 

El 

POP HL 

ED 5E 

IM 2 

E2 bb aa 

JP PO,aabb 

ED 5F 

LD A,R 

E3 

EX (SP),HL 

ED 60 

IN H,(C) 
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ED 61 


OUT (C) ,H 

ED 62 


SBC HL,HL 

ED 67 


RRD 

ED 68 


IN L,(C) 

ED 69 


OUT (C),L 

ED 6A 


ADC HL,HL 

ED 6F 


RLD 

ED 70 


IN F, (C) 

ED 72 


SBC HL,SP 

ED 73 

bb a a 

LD (aabb),SP 

ED 78 


IN A,(C) 

ED 79 


OUT (C), A 

ED 7A 


ADC HL,SP 

ED 7B 

bb aa 

I'D SP,(aabb) 

ED AO 


LDI 

ED A1 


CPI 

ED A2 


INI 

ED A3 


OUTI 

ED A8 


LDD 

ED A9 


CPD 

ED AA 


IND 

ED AB 


OUTD 

ED BO 


LDIR 

ED B1 


CPIR 

ED B2 


INIR 

ED B3 


OTIR 

ED B8 


LDDR 

ED B9 


CPDR 

ED BA 


INDR 

ED BB 


OTDR 

EE nn 


XOR nn 

EF 


RST 28 

FO 

FI 


RET P 

POP AF 

E2 bb aa 

J P P,aabb 


F3 




DI 


F4 

bb 

aa 


CALL P,aabb 

F5 




PUSH AF 

F6 

nn 



OR 

nn 

F7 




RST 

* 30 

F8 




RET 

1 M 

F9 




LD 

SP,HL 

FA 

bb 

aa 


JP 

M *aabb 

FB 




El 


FC 

bb 

aa 


CALL M,aabb 

FD 

09 



ADD 

1 iy,bc 

FD 

19 



ADD 

1 iy,de 

FD 

21 

bb 

aa 

LD 

IY f aabb 

FD 

22 

bb 

aa 

LD 

(aabb),iy 

FD 

23 



INC 

IY 

FD 

29 



ADD 

iy,iy 

FD 

2A 

bb 

aa 

LD 

IY,(aabb) 

FD 

2B 



DEC 

IY 

FD 

34 

nn 


INC 

(IY+nn) 

FD 

35 

nn 


DEC 

(IY+nn) 

FD 

36 

nn 

nl 

LD 

(IY+nn),nl 

FD 

39 



ADD 

IY, SP 

FD 

46 

nn 


LD 

B,(IY+nn) 

FD 

4E 

nn 


LD 

C,(IY+nn) 

FD 

56 

nn 


LD 

D,(IY+nn) 

FD 

5E 

nn 


LD 

E,(IY+nn) 

FD 

66 

nn 


LD 

H,(IY+nn) 

FD 

6 E 

nn 


LD 

L,(IY+nn) 

FD 

70 

nn 


LD 

(IY+nn),B 

FD 

71 

nn 


LD 

(IY+nn),C 

FD 

72 

nn 


LD 

(IY+nn),D 

FD 

73 

nn 


LD 

(IY+nn),E 

FD 

74 

nn 


LD 

(IY+nn),H 

FD 

75 

nn 


LD 

(IY+nn),L 

FD 

77 

nn 


LD 

(IY+nn),A 
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FD 7E nn 
FD 86 nn 
FD 8 E nn 
FD 96 nn 
FD 9E nn 
FD A 6 nn 
FD AE nn 
FD B 6 nn 
FD BE nn 
FD CB nn 06 
FD CB nn 0E 
FD CB nn 16 
FD CB nn IE 
FD CB nn 26 
FD CB nn 2E 
FD CB nn 36 
FD CB nn 3E 
FD CB nn 46 
FD CB nn 4E 
FD CB nn 56 
FD CB nn 5E 
FD CB nn 66 
FD CB nn 6 E 
FD CB nn 76 
FD CB nn 7E 
FD CB nn 86 
FD CB nn 8 E 
FD CB nn 96 
FD CB nn 9E 
FD CB nn A 6 
FD CB nn AE 
FD CB nn B 6 
FD CB nn BE 
FD CB nn C 6 
FD CB nn CE 


LD A,(IY+nn) 

ADD A,(IY+nn) 
ADC A,(IY+nn) 
SUB (IY+nn) 

SBC A,(IY+nn) 
AND (IY+nn) 

XOR (IY+nn) 

OR (IY+nn) 

CP (IY+nn) 

RLC (IY+nn) 

RRC (IY+nn) 

RL (IY+nn) 

RR (IY+nn) 

SLA (IY+nn) 

SRA (IY+nn) 

SLI (IY+nn) 

SRL (IY+nn) 

BIT 0,(IY+nn) 
BIT 1 , (IY+nn) 
BIT 2, (IY+nn) 
BIT 3 , (IY+nn) 
BIT 4,(IY+nn) 
BIT 5 , (IY+nn) 
BIT 6, (IY+nn) 
BIT 7 , (IY+nn) 
RES 0, (IY+nn) 
RES 1 , (IY+nn) 
RES 2, (IY+nn) 
RES 3, (IY+nn) 
RES 4 , (IY+nn) 
RES 5 ,(IY+nn) 
RES 6,(IY+nn) 
RES 7,(IY+nn) 
SET 0,(IY+nn) 
SET 1,(IY+nn) 


FD 

CB 

nn 

D 6 

SET 

2, 

(IY+nn) 

FD 

CB 

nn 

DE 

SET 

3, 

(IY+nn) 

FD 

CB 

nn 

E 6 

SET 

4, 

(IY+nn) 

FD 

CB 

nn 

EE 

SET 

s. 

(IY+nn) 

FD 

CB 

nn 

F 6 

SET 

6 , 

(IY+nn) 

FD 

CB 

nn 

FE 

SET 

2, 

(IY+nn) 

FD 

El 



POP 

IY 


FD 

E3 



EX 

(SP), IY 

FD 

E5 



PUSH IY 

FD 

E9 



JP 

(IY 

) 

FD 

F9 



LD 

SP, 

IY 

FE 

nn 



CP 

nn 


FF 




RST 

38 
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Instruction set in Alphabetical order 


8 E 

DD 8 E nn 
FD 8 E nn 
8 F 
88 
89 
8 A 
8 B 
8 C 
8 D 

CE nn 
ED 4A 
ED 5A 
ED 6 A 
ED 7A 

86 

DD 86 nn 
FD 86 nn 
87 
80 
81 
82 

83 

84 

85 

C 6 nn 

09 

19 

29 

39 

DD 09 
DD 19 
DD 29 

138 


ADC A,{HL) 

ADC A,(IX+nn) 
ADC A,(IY+nn) 
ADC A,A 
ADC A,B 
ADC A,C 
ADC A,D 
ADC A,E 
ADC A,H 
ADC A,L 
ADC A,nn 
ADC HL,BC 
ADC HL,DE 
ADC HL,HL 
ADC HL f SP 

ADD A, (HD 
ADD a,(IX+ nn) 
ADD A,(IY+nn) 
ADD A,A 
ADD A,B 
ADD A,C 
add A,D 
add a,e 
add A,H 
add A,L 
ADD A,nn 

add hl,bc 

A °D HL,DE 

add hl,hl 

add HL,SP 
ADD IX,BC 
ADD IX, DE 
ADD IX,IX 


DD 39 
FD 09 
FD 19 
FD 29 
FD 39 

A 6 

DD A 6 nn 

FD A 6 nn 

A7 

AO 

A1 

A2 

A3 

A4 

A5 

E 6 nn 
CB 46 

DD CB nn 46 
FD CB nn 46 
CB 47 
CB 40 
CB 41 
CB 42 
CB 43 
CB 44 
CB 45 

CB 4E 

DD CB nn 4E 

PD CB nn 4E 
CB 4F 

CB 48 


ADD IX,SP 
add IY,BC 
add iy,de 
add IY,iy 
add iy,sp 

and (HL) 
and (ix+nn) 
AND (IY+nn) 
AND A 
AND B 
AND C 
AND D 
AND E 
AND H 
AND L 
AND nn 

BIT 0, (HL) 
BIT 0,(IX+nn) 
BIT 0,(IY+nn) 
BIT 0,A 

bit o,b 
bit 0,C 
bit 0,D 
bit o,e 
bit o,h 
bit o,l 

B IT 1,(HL) 

BIT 1,(ix+nn) 

BIT 1,(IY+nn) 

bit 1, A 
BIT 1 , B 
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CB 49 
CB 4A 
CB 46 
CB 4C 
CB 40 


bit 1 f C 

BIT 1 r D 

bit 1f E 
BIT 1 

bit 1fL 


CB 61 
CB 62 
CB 63 
CB 64 
CB 65 


CB 56 

oD CB nn 56 
fD CB nn 56 
CB 57 
CB 50 
CB 51 
CB 52 
CB 53 
CB 54 
CB 55 


BIT 2,(HL) 

BIT 2,( IX+nn) 
BIT 2,( IY+nn) 
BIT 2,A 
BIT 2,B 
BIT 2 ,C 
BIT 2,D 
BIT 2,E 
BIT 2,H 
BIT 2,L 


CB 6E 

DD CB nn 6E 
FD CB nn 6E 
CB 6F 
CB 68 
CB 69 
CB 6A 
CB 6B 
CB 6C 
CB 6D 


BIT 4 ,C 
BIT 4 ,D 
BIT 4 ,E 
BIT 4 ,H 
BIT 4,L 

BIT 5,(HL) 

BIT 5,(IX+nn) 
BIT 5,(IY+nn) 
BIT 5,A 
BIT 5,B 
BIT 5 ,C 
BIT 5,D 
BIT 5 ,E 
BIT 5,H 
BIT 5 ,L 


CB 

5E 


BIT 

3 , (HL) 

DD 

CB nn 

5E 

BIT 

3,(IX+nn) 

FD 

CB nn 

5E 

BIT 

3 ,(IY+nn) 

CB 

5F 


BIT 

3,A 

CB 

58 


BIT 

3,B 

CB 

59 


BIT 

3,C 

CB 

5A 


BIT 

3 fD 

CB 

5B 


BIT 

3,E 

CB 

5C 


BIT 

3 ,H 

CB 

5D 


BIT 

3,L 


CB 

76 


BIT 

6,(HL) 

DD 

CB nn 

76 

BIT 

6,(IX+nn) 

FD 

CB nn 

76 

BIT 

6,(IY+nn) 

CB 

77 


BIT 

6, A 

CB 

70 


BIT 

6,B 

CB 

71 


BIT 

6 ,C 

CB 

72 


BIT 

6 ,D 

CB 

73 


BIT 

6 ,E 

CB 

74 


BIT 

6 ,H 

CB 

75 


BIT 

6 ,L 


CB 

66 


DD 

CB nn 

66 

FD 

CB nn 

66 

CB 

67 


CB 

60 



BIT 4,(HL) 

BIT 4, (IX+nn) 
BIT 4, (IY+nn) 
BIT 4,A 
BIT 4,B 


CB 7E 

DD CB nn 7E 
FD CB nn 7E 
CB 7F 
CB 78 


BIT 7,(HL) 

BIT 7 ,(IX+nn) 
BIT 7, (IY+nn) 
BIT 7,A 
BIT 7 ,B 
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2F 


CPL 


CB 79 
CB 7A 
CB 7B 
CB 7C 
CB 7D 


DC bb aa 
FC bb aa 
D4 bb aa 
CD bb aa 
C4 bb aa 
F4 bb aa 
EC bb aa 
E4 bb aa 
CC bb aa 


140 


BIT 7 ,C 
BIT 7,D 
BIT 7,E 
BIT 7,H 
BIT 7 ,L 


CALL C,aabb 
CALL M,aabb 
CALL NC,aabb 
CALL aabb 


CALL 

CALL 

CALL 

CALL 

CALL 


NZ,aabb 
P,aabb 
PE,aabb 
PO,aabb 
Z,aabb 


BE 


CP 

(H 

DD 

BE nn 

CP 

(I 

FD 

BE nn 

CP 

(I 

BF 


CP 

A 

B8 


CP 

B 

B9 


CP 

C 

BA 


CP 

D 

BB 


CP 

E 

BC 


CP 

H 

BD 


CP 

L 

FE 

nn 

CP 

nn 

ED 

A9 

CPD 


ED 

B9 

CPDR 

ED 

A1 

CPI 


ED 

B1 

CPIR 


35 

DD 35 nn 
FD 35 nn 
3D 


05 

OB 

OD 

15 

IB 

ID 

25 

2B 

DD 2B 
FD 2B 
2D 
3B 


10 nn 


E3 

DD E3 
FD E3 
08 


Scanm 


DEC (HL) 
DEC (IX+nn) 
DEC (IY+nn) 
DEC A 
DEC B 
DEC BC 
DEC C 
DEC D 
DEC DE 
DEC E 
DEC H 
DEC HL 
DEC IX 
DEC IY 
DEC L 
DEC SP 


DJNZ nn 


EX (SP),HL 
EX (SP),IX 
EX (SP),IY 
EX AF,AF' 
EX DE,HL 
EXX 


HALT 


I 




1 


gD 46 

IM 0 

gD 56 

IM 1 

£D 5E 

IM 2 

£D 78 

IN A,(C) 

DB nn 

IN A,(nn) 

O 

*^r 

Q 

IN B,(C) 

£D 48 

IN C f (C) 

ED 50 

IN D,(C) 

ED 58 

IN E,(C) 

ED 70 

IN F,(C) 

ED 60 

IN H,(C) 

ED 68 

IN L,(C) 

34 

INC (HL) 

DD 34 nn 

INC (IX+nn) 

FD 34 nn 

INC (IY+nn) 

3C 

INC A 

04 

INC B 

03 

INC BC 

OC 

INC C 

14 

INC D 

13 

INC DE 

1C 

INC E 

24 

INC H 

23 

INC HL 

DD 23 

INC IX 

FD 23 

INC IY 

2C 

INC L 

33 

INC SP 

ED AA 

IND 

ED BA 

IN DR 

ED A2 

INI 

ED B2 

INIR 


E9 


JP 

(HL) 

DD E9 


JP 

(IX) 

FD E9 _ 


JP 

(IY) 

bb aa 


Jr 

C # aabb 

^A bb aa . 

°2 bb aa 

ur 

M *aabb 

JP 

NC,aabb 

C3 bb aa 

JP 

aabb 

C 2 bb aa 

JP 

NZ,aabb 

E 2 bb aa 

JP 

E\aabb 

EA bb aa 

JP 

PE,aabb 

E2 bb aa 

JP 

P0,aabb 

CA bb aa 

JP 

Z,aabb 

38 nn 

JR 

C,nn 

1 8 nn 

JR 

nn 

30 nn 

JR 

NC,nn 

20 nn 

JR 

NZ,nn 

28 nn 

JR 

Z ,nn 

02 

LD 

(BC),A 

12 

LD 

(DE),A 

77 

LD 

(HL),A 

70 

LD 

(HL),B 

71 

LD 

(HL),C 

72 

LD 

(HL),D 

73 

LD 

(HL),E 

74 

LD 

(HL),H 

75 

LD 

(HL),L 

36 nn 

LD 

(HL),nn 

DD 77 nn 

LD 

(IX+nn),A 

DD 70 nn 

LD 

(IX+nn),B 

DD 71 nn 

LD 

i (IX+nn),C 

DD 72 nn 

LD (IX+nn),D 

DD 73 nn 

LD (IX+nn),E 
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DD 74 nn 
DD 75 nn 
DD 36 nn nl 

FD 77 nn 
FD 70 nn 
FD 71 nn 
FD 72 nn 
FD 73 nn 
FD 74 nn 
FD 75 nn 
FD 36 nn nl 

32 bb aa 
ED 43 bb aa 
ED 53 bb aa 
22 bb aa 
DD 22 bb aa 
FD 22 bb aa 
ED 73 bb' aa 

0A 
1A 
7E 

DD 7E nn 
FD 7E nn 
3A bb aa 
7F 

78 

79 
7A 
7b 
7C 

ED 57 


LD (IX+nn),H 
LD (IX+nn),L 
LD (IX+nn),nl 

LD (IY+nn),A 
LD (IY+nn),B 
LD (IY+nn),C 
LD (IY+nn),D 
LD (IY+nn),E 
LD (IY+nn),H 
LD (IY+nn),L 
LD (IY+nn),n1 

LD (aabb),A 
LD (aabb),BC 
LD (aabb),DE 
LD ( aabb) ,HL 
LD (aabb),ix 
LD (aabb),lY 
LD (aabb),SP 

LD A,(BC) 

LD A,(DE) 

LD A,(HL) 

LD A,(IX+nn) 
LD A,(IY+nn) 
LD A,(aabb) 

LD A,A 
LD A,B 
LD A, C 
LD A,D 
LD A,E 
LD A,H 
LD A # I 


7D 

3E nn 
ED 5F 

46 

DD 46 nn 
FD 46 nn 

47 

40 

41 

42 

43 

44 

45 

06 nn 

ED 4B bb aa 
01 bb aa 

4E 

DD 4E nn 
FD 4E nn 
4F 

48 

49 
4A 
4B 
4C 
4D 

OE nn 
56 

DD 56 nn 

FD 56 nn 


LD A,L 
LD A,nn 
LD A,R 

LD B,(HL) 

LD B,(IX+nn) 
LD B,(IY+nn) 
LD B,A 
LD B,B 
LD B,C 
LD B,D 
LD B,E 
LD B,H 
LD B,L 
LD B,nn 

LD BC,(aabb) 
LD BC,aabb 

LD C , (HL) 

LD C,(IX+nn) 
LD C,(IY+nn) 
LD C,A 
LD C,B 
LD C,C 
LD C, D 
LD C,E 
LD C,H 
LD C,L 
LD C,nn 

LL D,(HL) 

LD D,(IX+nn) 
LD D,(IY+nn) 


142 


Scanned by CamScanner 



57 

< 

a 

a 

*4 

50 

LD D r B 

51 

LD d,c 

52 

ld d,d 

53 

LD D,E 

ld D,L 

16 nn 

LD D # nn 

gD 5B bb aa 

LD DE,(aabb) 

11 bb aa 

LD DE,aabb 

5E 

LD E,(HL) 

DD 5E nn 

LD E,(IX+nn) 

FD 5E nn 

LD E,(IY+nn) 

5F 

LD E, A 

58 

0 

LD E,B 

59 

LD E f C 

5A 

LD E,D 

5B 

LD E f E 

5C 

LD E f H 

5D 

LD E ,L 

IE nn 

LD E,nn 

66 

LD H,(HL) 

DD 66 nn 

LD H,(IX+nn 

FD 66 nn 

LD H/(IY+nn 

67 

LD H, A 

60 

LD H,B 

61 

LD H,C 

62 

LD H r D 

63 

64 

65 

26 nn 

LD H,E 

LD H,H 

LD H,L 

LD H,nn 


2A 

bb 

aa 


LD 

HL t 

(aabb) 

21 

bb 

aa 


LD 

HL, 

aabb 

ED 

47 



LD 

I,A 


DD 

21 

bb 

aa 

LD 

IX, 

aabb 

FD 

2A 

bb 

aa 

LD 

IY, 

(aabb) 

FD 

21 

bb 

aa 

LD 

IY, 

aabb 


6 E 

ld L,(HL) 

DD 6E nn 

ld L,(IX+nn) 

FD 6E nn 

LD L,(IY+nn) 

6 F 

LD L,A 

68 

LD L,B 

69 

LD L,C 

6 A 

LD L,D 

6 B 

LD L,E 

6 C 

LD L,H 

6 D 

LD L,L 

2E nn 

LD L,nn 

ED 4F 

LD R, A 

ED 7B bb aa 

LD SP,(aabb) 

F9 

LD SP,HL 

DD F9 

LD SP,IX 

FD F9 

LD SP,IY 

31 bb aa 

LD SP,aabb 

ED A8 

LDD 

ED B8 

LDDR 

ed AO 

LDI 

ED BO 

ldir 
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ED 

44 

NEG 


DD 

El 



POP 

IX 





FD 

El 



POP 

IY 

00 


NOP 












F5 




PUSH AF 

B6 


OR 

(HL) 

C5 




PUSH BC 

DD 

B6 nn 

OR 

(IX+nn) 

D5 




PUSH DE 

FD 

B6 nn 

OR 

(IY+nn) 

E5 




PUSH HL 

B7 


OR 

A 

DD 

E5 



PUSH IX 

BO 


OR 

B 

FD 

E5 



PUSH IY 

B1 


OR 

C 







B2 


OR 

D 

CB 

86 



RES 

0 * (HL) 

B3 


OR 

E 

DD 

CB 

nn 

86 

RES 

0, (IX+nn) 

B4 


OR 

H 

FD 

CB 

nn 

86 

RES 

0, (IX+nn) 

B5 


OR 

L 

CB 

87 



RES 

0,A 

F6 

nn 

OR 

nn 

CB 

80 



RES 

0 ,B 





CB 

81 



RES 

0,C 

ED 

BB 

OTDR 

CB 

82 



RES 

0 ,D 

ED 

B3 

OTIR 

CB 

83 



RES 

0 ,E 





CB 

84 



RES 

0 ,H 

ED 

79 

OUT 

(C), A 

CB 

85 



RES 

0 ,L 

ED 

41 

OUT 

(C), B 







ED 

49 

OUT 

(C),c 

CB 

8E 



RES 

1 ,(HL) 

ED 

51 

OUT 

(C),D 

DD 

CB 

nn 

8E 

RES 

1,(IX+nn) 

ED 

59 

OUT 

(C),E 

FD 

CB 

nn 

8E 

RES 

1,(IY+nn) 

ED 

61 

OUT 

(C),H 

CB 

8F 



RES 

1 , A 

ED 

69 

OUT 

(C), L 

CB 

88 



RES 

1 ,B 

D3 

nn 

OUT 

(nn),A 

CB 

89 



RES 

1 ,C 





CB 

8A 



RES 

1 ,D 

ED 

AB 

OUTD 

CB 

8B 



RES 

1 ,E 

ED 

A3 

OUTI 

CB 

8C 



RES 

1 ,H 





CB 

8D 



RES 

1 ,L 

FI 


POP 

AF 







Cl 


POP 

BC 

CB 

96 



RES 

2,(HL) 

D1 


POP 

DE 

DD 

CB 

nn 

96 

RES 

2,(IX+nn) 

El 


POP 

HL 

FD 

CB 

nn 

96 

RES 

2 , (IY+nn) 
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CB 97 
CB 90 
CB 91 
CB 92 
CB 93 
CB 94 
CB 95 

CB 9E 

D D CB nn 9E 
FD CB nn 9E 

CB 9F 
CB 98 
CB 99 
CB 9A 
CB 9B 
CB 9C 
CB 9D 

CB A 6 

DD CB nn A6 
FD CB nn A6 
CB A 7 
CB AO 
CB A1 
CB A2 
CB A3 
CB A4 
CB A5 

CB AE 

DD CB nn AE 
FD CB nn AE 
CB AF 
CB A8 


RES 2,A 
RES 2,B 
RES 2,C 
RES 2,D 
RES 2,E 
RES 2 ,H 
RES 2,L 

RES 3 f (HL) 

RES 3 , ( IX+nn) 
RES 3 , ( IY+nn) 
RES 3, A 
RES 3 ,B 
RES 3,C 
RES 3 r D 
RES 3/E 
RES 3,H 
RES 3,L 

RES 4 ,(HL) 

RES 4 , (IX+nn) 
RES 4 ,(IY+nn) 
RES 4,A 
RES 4,B 
RES 4,C 
RES 4,D 
RES 4,E 
RES 4,H 
RES 4 ,L 

RES 5,(HL) 

RES 5,(IX+nn) 
RES 5,(IY+nn) 
RES 5,A 
RES 5,B 


l-fl 










A9 



RES 

5,C 

AA 



RES 

5,0 

AB 



RES 

5,E 

AC 



RES 

5,H 

AD 



RES 

5,L 

B6 



RES 

6 ,<HL) 

CB 

nn 

B 6 

RES 

6, (IX+nn) 

CB 

nn 

B 6 

RES 

6 , (IY+nn) 

B7 



RES 

6 / A 

BO 



RES 

6 ,B 

Bl 



RES 

6 ,C 

B2 



RES 

6 , D 

B3 



RES 

6 ,E 

B4 



RES 

6 ,H 

B5 



RES 

6 ,L 

BE 



RES 

1, (HL) 

CB 

nn 

BE 

RES 

1, (IX+nn) 

CB 

nn 

BE 

RES 

7, (IY+nn) 

BF 



RES 

7,A 

B 8 



RES 

7,B 

B9 



RES 

7,C 

BA 



RES 

1,0 

BB 



RES 

7,E 

BC 



RES 

7/H 

BD 



RES 

7,L 


C9 

D8 

F8 

DO 

CO 

FO 

E8 


RET 
RET C 
RET M 
RET NC 
RET NZ 
RET P 
RET PE 
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EO 

C8 

ED 4D 
ED 45 

CB 16 

DD CB nn 16 
FD CB nn 16 
CB 17 
CB 10 
CB 11 
CB 12 
CB 13 
CB 14 
CB 15 

17 

CB 06 

DD CB nn 06 
FD CB nn 06 
CB 07 
CB 00 
CB 01 
CB 02 
CB 03 
CB 04 
CB 05 

07 

ED 6F 
CB IE 


RET PO 
RET Z 

RETI 

RETN 

RL (HL) 

RL (IX+nn) 
RL (IY*nn) 
RL A 
RL B 
RL C 
RL D 
RL E 
RL H 
RL L 

RLA 

RLC (HL) 

RLC (IX+nn) 
RLC (IY+nn) 
RLC A 
RLC B 
RLC C 
RLC D 
RLC E 
RLC H 
RLC L 

RLCA 

RLD 

RR (HL) 
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9E 


SBC A,(HL) 

CB C9 


SET 

1 ,C 

DD 9E nn 


SBC A, (IX+nn) 

CB CA 


SET 

1 , D 

fD 9E nn 


SBC A,(IY+nn) 

CB CB 


SET 

1 ,E 

9F 


SBC A,A 

CB CC 


SET 

1 ,H 

98 


SBC A,B 

CB CD 


SET 

1 ,L 

99 


SBC A, C 





9A 


SBC A,D 

CB D6 


SET 

2,(HL) 

9B 


SBC A,E 

DD CB nn 

D6 

SET 

2,(IX+nn) 

9C 


SBC A,H 

FD CB nn 

D6 

SET 

2,(IY+nn) 

9D 


SBC A,L 

CB D7 


SET 

2 , A 

DE nn 


SBC A,nn 

CB DO 


SET 

2,B 




CB D1 


SET 

2 ,C 

ED 42 


SBC HL f BC 

CB D2 


SET 

2 ,D 

ED 52 


SBC HL ,DE 

CB D3 


SET 

2 ,E 

ED 62 


SBC HL,HL 

CB D4 


SET 

2 ,H 

ED 72 


SBC HL,SP 

CB D5 


SET 

2 ,L 

37 


SCF 

CB DE 


SET 

3,(HL) 




DD CB nn 

DE 

SET 

3,(IX+nn) 

CB C6 


SET 0 r (HL) 

FD CB nn 

DE 

SET 

3, (IY+nn) 

DD CB nn 

C6 

SET 0,(IX+nn) 

CB DF 


SET 

3,A 

FD CB nn 

C6 

SET 0, (IY+nn) 

CB D8 


SET 

3,B 

CB C7 


SET 0, A 

CB D9 


SET 

3,C 

CB CO 


SET 0,B 

CB DA 


SET 

3 ,D 

CB Cl 


SET 0,C 

CB DB 


SET 

3 ,E 

CB C2 


SET 0 ,D 

CB DC 


SET 

3 ,H 

CB C3 


SET 0,E 

CB DD 


SET 

3 f L 

CB C4 


SET 0 ,H 





CB C5 


SET 0 ,L 

CB E6 


SET 

4,(HL) 




DD CB nn 

E6 

SET 

4 r (IX+nn) 

CB CE 


SET 1 , (HL) 

FD CB nn 

E6 

SET 

4 , (IY+nn) 

DD CB nn 

CE 

SET 1,(IX+nn) 

CB E7 


SET 

4 # A 

FD CB nn 

i CE 

SET 1,(IY+nn) 

CB EO 


SET 

4,B 

CB CF 


SET 1,A 

CB El 


SET 

4,C 

CB C8 


SET 1,B 

CB E2 


SET 

4 , D 
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CB E3 
CB E4 
CB E5 


SET 4,E 
SET 4 ,H 
SET 4 ,L 


CB 26 SLA (HL) 

DD CB nn 26 SLA (IX+nn) 
FD CB nn 26 SLA (IY+nn) 
CB 27 SLA A 


CB EE 



SET 5,(HL) 

CB 

20 



SLA 

B 

DD CB 

nn 

EE 

SET 5,(IX+nn) 

CB 

21 



SLA 

C 

FD CB 

nn 

EE 

SET 5,(IY+nn) 

CB 

22 



SLA 

D 

CB EF 



SET 5,A 

CB 

23 



SLA 

E 

CB E8 



SET 5 ,B 

CB 

24 



SLA 

H 

CB E9 



SET 5 ,C 

CB 

25 



SLA 

L 

CB EA 



SET 5, D 







CB EB 



SET 5,E 

CB 

36 



SLI 

(HL) 

CB EC 



SET 5, H 

DD 

CB 

nn 

36 

SLI 

(IX+nn) 

CB ED 



SET 5,L 

FD 

CB 

nn 

36 

SLI 

(IY+nn) 





CB 

37 



SLI 

A 

CB F6 



SET 6, (HL) 

CB 

30 



SLI 

B 

DD CB 

nn 

F6 

SET 6, (IX+nn) 

CB 

31 



SLI 

C 

FD CB 

nn 

F6 

SET 6,(IY+nn) 

CB 

32 



SLI 

D 

CB F7 



SET 6,A 

CB 

33 



SLI 

E 

CB FO 



SET 6 ,B 

CB 

34 



SLI 

H 

CB FI 



SET 6,C 

CB 

35 



SLI 

L 

CB F2 



SET 6,D 







CB F3 



SET 6,E 

CB 

2E 



SRA 

(HL) 

CB F4 



SET 6 ,H 

DD 

CB 

nn 

2E 

SRA 

(IX+nn) 

CB F5 



SET 6,L 

FD 

CB 

nn 

2E 

SRA 

(IY+nn) 





CB 

2F 



SRA 

A 

CB FE 



SET 7,(HL) 

CB 

28 



SRA 

B 

DD CB 

nn 

FE 

SET 7,(IX+nn) 

CB 

29 



SRA 

C 

FD CB ; 

nn 

FE 

SET 1, (IY+nn) 

CB 

2A 



SRA 

D 

CB FF 



SET 7 ,A 

CB 

2B 



SRA 

E 

CB F8 



SET 7,B 

CB 

2C 



SRA 

H 

CB F9 



SET 7 ,C 

CB 

2D 



SRA 

L 

CB FA 



SET 7,D 







CB FB 



SET 7,E 

CB 

3E 



SRL 

(HL) 

CB FC 



SET 7 , H 

DD 

CB 

nn 

3E 

SRL 

(IX+nn) 

CB FD 



SET 7,L 

FD 

CB 

nn 

3E 

SRL 

(IY+nn) 
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CB 3F 
CB 38 
CB 39 
CB 3A 
CB 3B 
CB 3C 
CB 3D 


DD 96 nn 
FD 96 nn 


SRL A 
SRL B 
SRL C 
SRL D 
SRL E 
SRL H 
SRL L 


SUB (HL) 

SUB (IX>nn) 
SUB (IY+nn) 
SUB A 


SUB B 
SUB C 
SUB D 
SUB E 


D6 nn 


DD AE nn 
FD AE nn 


EE nn 


SUB H 
SUB L 
SUB nn 


XOR (HL) 

XOR (IX*nn) 
XOR (IY+nn) 
XOR A 
XOR B 
XOR C 
XOR D 
XOR E 
XOR H 
XOR L 
XOR nn 


m. 

| i 

m 

wx 

if 

I: ; 

r;i' 

j.-| * 

V- •: 


! n 
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HEX DEC 


D H 


_ *-236 

00 00000 
01 00256 
02 00512 
03 00768 
04 01024 
05 01280 
06 01536 
07 01792 
08 02048 
09 02304 
0A 02560 
OB 02816 
OC 03072 
OD 03328 
OE 03584 
OF 03840 

10 04096 

11 04352 

12 04608 

13 04864 

14 05120 

15 05376 

16 05632 

17 05888 

18 06144 

19 0C400 
1A 06656 
IB 06912 
1C 07168 
ID 07424 
IE 07680 
IF 07936 

20 08192 

21 08448 

22 08704 

23 08960 

24 09216 

25 09472 

26 09728 

27 09984 

28 10240 

29 10496 
2A 10752 
2B 11008 
2C 11264 
2D 11520 
2E 11776 
2F 12032 

30 12288 

31 12544 

32 12800 

33 13056 


34 13312 

35 13568 

36 13824 

37 14080 

38 14336 

39 14592 
3A 14848 
3B 15104 
3C 15360 
3D 15616 
3E 15872 
3F 16128 

40 16384 

41 16640 

42 16896 

43 17152 

44 17408 

45 17664 

46 17920 

47 18176 

48 18432 

49 18688 
4A 18944 
4B 19200 
4C 19456 
4D 19712 
4E 19968 
4F 20224 

50 20480 

51 20736 

52 20992 

53 21248 

54 21504 

55 21760 

56 22016 

57 22272 

58 22528 

59 22784 
5A 23040 
5B 23296 
5C 23552 
5D 23808 
5E 24064 
5F 24320 

60 24576 

61 24832 

62 25088 

63 25344 

64 25600 

65 25856 

66 26112 
67 26368 


68 26624 

69 26880 
6A 27136. 
6B 27392 
6C 27648 
6D 27904 
6E 28160 
6F 28416 

70 28672 

71 28928 

72 29184 

73 29440 

74 29696 

75 29952 

76 30208 

77 30464 

78 30720 

79 30976 
7A 31232 
7B 31488 
7C 31744 
7D 32000 
7E 32256 
7F 32512 

80 32768 

81 33024 

82 33280 

83 33536 

84 33792 

85 34048 

86 34304 

87 34560 

88 34816 

89 35072 
8A 35328 
8B 35584 
8C 35840 
8D 36096 
8E 36352 
8F 36608 

90 36864 

91 37120 

92 37376 

93 37632 

94 37888 

95 38144 

96 38400 

97 38656 

98 38912 

99 39168 
9A 39424 
9B 39680 


108 AO 

109 A1 

110 A2 

111 A3 

112 A4 

113 A5 

114 A6 

115 A 7 

116 A8 

117 A9 

118 AA 

119 AB 

120 AC 

121 AD 

122 AE 

123 AF 

124 BO 

125 B1 

126 B2 

127 B3 

128 B4 

129 B5 

130 B6 

131 B7 

132 B8 

133 B9 

134 BA 

135 BB 

136 BC 

137 BD 

138 BE 

139 BF 

140 CO 

141 Cl 

142 C2 

143 C3 

144 C4 

145 C5 

146 C6 

147 Cl 

148 C8 

149 C9 

150 CA 

151 CB 

152 CC 

153 CD 

154 CE 

155 CF 


39936 

40192 

40448 

40704 

40960 

41216 

41472 

41728 

41984 

42240 

42496 

42752 

43008 

43264 

43520 

43776 

44032 

44288 

44544 

44800 

45056 

45312 

45568 

45824 

46080 

46336 

46592 

46848 

47104 

47360 

47616 

47872 

48128 

48384 

48640 

48896 

49152 

49408 

49664 

49920 

50176 

50432 

50688 

50944 

51200 

51456 

51712 

51968 

52224 

52480 

52736 

52992 


156 

157 

158 

159 

160 
161 
162 

163 

164 

165 

166 

167 

168 

169 

170 

171 

172 

173 

174 

175 

176 

177 

178 

179 

180 
181 
182 

183 

184 

185 

186 

187 

188 

189 

190 

191 

192 

193 

194 

195 

196 

197 

198 

199 

200 
201 
202 

203 

204 

205 

206 
207 


DO 53248 
D1 53504 
D2 53760 
D3 54016 
D4 54272 
D5 54528 
D6 54784 
D7 55040 
D8 55296 
D9 55552 
DA 55808 
DB 56064 
DC 56320 
DD 56576 
DE 56832 
DF 57088 
EO 57344 
El 57600 
E2 57856 
E3 58112 
E4 58368 
E5 58624 
E6 58880 
E7 59136 
E8 59392 
E9 59648 
EA 59904 
EB 60160 
EC 60416 
ED 60672 
EE 60928 
EF 61184 
FO 61440 
FI 61696 
F2 61952 
F3 62208 
F4 62464 
F5 62720 
F6 62976 
F7 63232 
F8 63488 
F9 63744 
FA 64000 
FB 64256 
FC 64512 
FD 64768 
FE 65024 
FF 65280 


208 

209 

210 
211 
212 

213 

214 

215 

216 

217 

218 

219 

220 
221 
222 

223 

224 

225 

226 

227 

228 

229 

230 

231 

232 

233 

234 

235 

236 

237 

238 

239 

240 

241 

242 

243 

244 

245 

246 

247 

248 

249 

250 

251 

252 

253 

254 

255 


The left column is the Hex code. ' 

The centre column is the decimal equivalent multiplied by 256 for 
calculating the M.S.B 

The third column is for use with the L.S.B. or single byte. 

a 
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INDEX 


A 4 f 


re 9 manipulation 


ADD a/adc A 

AND 

A Register 

Assembly commands 


51 

42 

43 
17 
29 


B 4 C Registers 
BIT 

Bit manipulation 
Block comparisons 
Block transfer group 
Brackets convention 
Byte search program 


17 

49 

49 

55 

39 

30 

121 


Calls 

Carry flag 

CCF 

CP 

CPI/CPD/CPIR/CPDR 

CPL 

Crashes 


59 

22 

53 

45 

55 

52 

85 




D 4 E Registers 
DAA 

Data manip. commands 
Data transfer commands 
Decimal arith. rotates 
Direct screen addressinq 
DJNZ 


18 

51 

41 

31 

48 

2 

58 


EX/EXX 


37 


Flag Register 19 

Flag table 23 


H 4 L Registers 18 
Half carry flag 21 
Halt 62 
Hex to opcode table 127 
Hooks 95 


I 4 R Registers 26 

IN 61 

Index registers 24 

INI/INIR/IND/INDR 61 

Input/Output commands 61 

Jumps 56 

LDI/LDIR/LDD/LDDR 39 

Loader program 104 


Machine code from Basic 1 
MSX Routines 86 
Music program 86 


NEG 


52 


N °n Z80 
NOP 


lns truction s 


OR 

OUT 


0UT1 '°n R/0UTD/0TDR 


ram 

Re- 

RES 


Pointers 

routine, programs 


Restore 

Returns 

RL 

RLC 


RLD/rrd 
ROM routines 
RR/RRC 


Saving programs 
SCF 

Screen messages 
SET 

Sign flag 
SLA/SRA 
Sprites 
SRL 

Stack pointer 
Storing Screens 
SUB 

Subtract flag 
System controls 


Table construction 


User inputs 1 
User inputs 2 
Using ZEN Assembler 
USR 


XOR 

Z80 Instructions 
Z80 Instruction table 
Zero flag 



8 bit arithmetic group 
8 bit load group 
8 bit registers 
8 bit shift/rotate 


16 bit arithmetic group 45 
16 bit load group 
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